"Fossies" - the Fresh Open Source Software Archive

Member "apache-log4j-2.12.4-src/src/changes/announcement.vm" (28 Dec 2021, 4795 Bytes) of package /linux/misc/apache-log4j-2.12.4-src.tar.gz:

    1 ## Licensed to the Apache Software Foundation (ASF) under one
    2 ## or more contributor license agreements.  See the NOTICE file
    3 ## distributed with this work for additional information
    4 ## regarding copyright ownership.  The ASF licenses this file
    5 ## to you under the Apache License, Version 2.0 (the
    6 ## "License"); you may not use this file except in compliance
    7 ## with the License.  You may obtain a copy of the License at
    8 ##
    9 ##  http://www.apache.org/licenses/LICENSE-2.0
   10 ##
   11 ## Unless required by applicable law or agreed to in writing,
   12 ## software distributed under the License is distributed on an
   13 ## "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
   14 ## KIND, either express or implied.  See the License for the
   15 ## specific language governing permissions and limitations
   16 ## under the License.
   17 #set($h1='#')
   18 #set($h2='##')
   19 #set($h3='###')
   20 #set($relVersion=$announceParameters.releaseVersion)
   21 #set($relCount=$announceParameters.releaseCount)
   22 #macro(formatAction $item)
   23 ## Use replaceAll to fix up LF-only line ends on Windows.
   24 ## Also replace < and > with entity versions to avoid HTML being misinterpreted.
   25 #set($action=$item.action.replaceAll("\n","
   26 ").replaceAll("<", "&lt;").replaceAll(">", "&gt;"))
   27 #if($item.issue)
   28 #set($issue = $item.issue)
   29 #set($url = "https://issues.apache.org/jira/browse/$issue")
   30 #else
   31 #set($issue = "")
   32 #end
   33 * #if($issue)[$issue]($url):#end
   34 
   35 ${action}#if($item.dueTo) Thanks to ${item.dueTo}.#end
   36 
   37 #end
   38 ## -----------------------------------------
   39 <!---
   40  Licensed to the Apache Software Foundation (ASF) under one or more
   41  contributor license agreements.  See the NOTICE file distributed with
   42  this work for additional information regarding copyright ownership.
   43  The ASF licenses this file to You under the Apache License, Version 2.0
   44  (the "License"); you may not use this file except in compliance with
   45  the License.  You may obtain a copy of the License at
   46 
   47       http://www.apache.org/licenses/LICENSE-2.0
   48 
   49  Unless required by applicable law or agreed to in writing, software
   50  distributed under the License is distributed on an "AS IS" BASIS,
   51  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   52  See the License for the specific language governing permissions and
   53  limitations under the License.
   54 -->
   55 $h1 Apache Log4j ${relVersion} Release Notes
   56 
   57 The ${developmentTeam} is pleased to announce the Log4j ${relVersion} release!
   58 
   59 Apache Log4j is a well known framework for logging application behavior. Log4j 2 is an upgrade
   60 to Log4j that provides significant improvements over its predecessor, Log4j 1.x, and provides
   61 many other modern features such as support for Markers, lambda expressions for lazy logging,
   62 property substitution using Lookups, multiple patterns on a PatternLayout and asynchronous
   63 Loggers. Another notable Log4j 2 feature is the ability to be "garbage-free" (avoid allocating
   64 temporary objects) while logging. In addition, Log4j 2 will not lose events while reconfiguring.
   65 
   66 The artifacts may be downloaded from https://logging.apache.org/log4j/2.x/download.html.
   67 
   68 This release contains the changes noted below:
   69 
   70 * Address CVE-2021-44832.
   71 
   72 This release addresses CVE-2021-44832 for users still using Java 7.
   73 
   74 The Log4j ${relVersion} API, as well as many core components, maintains binary compatibility with previous releases.
   75 
   76 ## Hack to improve layout: replace all pairs of spaces with a single new-line
   77 $h2 $release.description.replaceAll("  ", "
   78 ")
   79 
   80 #if ($release.actions.size() == 0)
   81 No changes defined in this version.
   82 #else
   83 Changes in this version include:
   84 
   85 #if ($release.getActions('add').size() !=0)
   86 $h3 New Features
   87 #foreach($actionItem in $release.getActions('add'))
   88 #formatAction($actionItem)
   89 #end
   90 #end
   91 
   92 #if ($release.getActions('fix').size() !=0)
   93 $h3 Fixed Bugs
   94 #foreach($actionItem in $release.getActions('fix'))
   95 #formatAction($actionItem)
   96 #end
   97 #end
   98 
   99 #if ($release.getActions('update').size() !=0)
  100 $h3 Changes
  101 #foreach($actionItem in $release.getActions('update'))
  102 #formatAction($actionItem)
  103 #end
  104 #end
  105 
  106 #if ($release.getActions('remove').size() !=0)
  107 $h3 Removed
  108 #foreach($actionItem in $release.getActions('remove'))
  109 #formatAction($actionItem)
  110 #end
  111 #end
  112 ## End of main loop
  113 #end
  114 ---
  115 
  116 Apache Log4j ${relVersion} requires a minimum of Java 7 to build and run. Log4j 2.3 was the
  117 last release that supported Java 6.
  118 
  119 Basic compatibility with Log4j 1.x is provided through the log4j-1.2-api component, however it
  120 does not implement some of the very implementation specific classes and methods. The package
  121 names and Maven groupId have been changed to org.apache.logging.log4j to avoid any conflicts
  122 with log4j 1.x.
  123 
  124 For complete information on ${project.name}, including instructions on how to submit bug
  125 reports, patches, or suggestions for improvement, see the Apache ${project.name} website:
  126 
  127 ${project.url}