Repository: logging-log4j2 Updated Branches: refs/heads/master a7515c1e7 -> 6621be5a0
Prepare for release Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/6621be5a Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/6621be5a Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/6621be5a Branch: refs/heads/master Commit: 6621be5a0062f74ae234202596b0f4f4083e5f85 Parents: a7515c1 Author: Ralph Goers <[email protected]> Authored: Sun Sep 17 21:11:05 2017 -0700 Committer: Ralph Goers <[email protected]> Committed: Sun Sep 17 21:11:05 2017 -0700 ---------------------------------------------------------------------- README.md | 27 +--- RELEASE-NOTES.md | 240 +++++----------------------- pom.xml | 2 +- src/changes/announcement.vm | 15 +- src/changes/changes.xml | 2 +- src/site/resources/images/logo.png | Bin 33960 -> 31667 bytes src/site/resources/logo/logo-2.9.1.png | Bin 0 -> 31667 bytes src/site/resources/logo/logo-2.9.1.xcf | Bin 0 -> 63493 bytes 8 files changed, 57 insertions(+), 229 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6621be5a/README.md ---------------------------------------------------------------------- diff --git a/README.md b/README.md index b646d1e..98d95cf 100644 --- a/README.md +++ b/README.md @@ -9,31 +9,8 @@ and provides many of the improvements available in Logback while fixing some inh ## Usage -Maven users can add the following dependencies to their `pom.xml` file: - -```xml -<dependencies> - <dependency> - <groupId>org.apache.logging.log4j</groupId> - <artifactId>log4j-api</artifactId> - <version>2.9.0</version> - </dependency> - <dependency> - <groupId>org.apache.logging.log4j</groupId> - <artifactId>log4j-core</artifactId> - <version>2.9.0</version> - </dependency> -</dependencies> -``` - -Gradle users can add the following to their `build.gradle` file: - -```gradle -dependencies { - compile group: 'org.apache.logging.log4j', name: 'log4j-api', version: '2.9.0' - compile group: 'org.apache.logging.log4j', name: 'log4j-core', version: '2.9.0' -} -``` +Users should refer to [Maven, Ivy, Gradle, and SBT Artifacts](http://logging.apache.org/log4j/2.x/maven-artifacts.html) +on the Log4j web site for instructions on how to include Log4j into their project using their chosen build tool. Basic usage of the `Logger` API: http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6621be5a/RELEASE-NOTES.md ---------------------------------------------------------------------- diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md index c1c0d2e..55cd0f9 100644 --- a/RELEASE-NOTES.md +++ b/RELEASE-NOTES.md @@ -1,6 +1,6 @@ -# Apache Log4j 2.9.0 Release Notes +# Apache Log4j 2.9.1 Release Notes -The Apache Log4j 2 team is pleased to announce the Log4j 2.9.0 release! +The Apache Log4j 2 team is pleased to announce the Log4j 2.9.1 release! Apache Log4j is a well known framework for logging application behavior. Log4j 2 is an upgrade to Log4j that provides significant improvements over its predecessor, Log4j 1.x, and provides @@ -9,15 +9,18 @@ property substitution using Lookups, multiple patterns on a PatternLayout and as Loggers. Another notable Log4j 2 feature is the ability to be "garbage-free" (avoid allocating temporary objects) while logging. In addition, Log4j 2 will not lose events while reconfiguring. -This release contains the first support of Java 9 as well as bugfixes and minor -enhancements. The Log4j API was modified to use java.util.ServiceLoader to locate Log4j implementations, +This release contains bugfixes and minor enhancements. + +As of Log4j 2.9.0, the Log4j API was modified to use java.util.ServiceLoader to locate Log4j implementations, although the former binding mechanism is still supported. The Log4j jar is now a multi-release jar -to provide implementations of the Java 9 specific classes. Multi-release jars are not supported by +to provide implementations of Java 9 specific classes. Multi-release jars are not supported by the OSGi specification so OSGi modules will not be able to take advantage of these implementations but will not lose functionality as they will fall back to the implementations used in Java 7 and 8. -More details on the new features and fixes are itemized below. +More details on the new features and fixes are itemized below. Note that some tools are not compatible +with multi-release jars and may fail trying to process class files in the META-INF/versions/9 folder. +Those errors should be reported to the tool vendor. -Note that subsequent to the 2.9 release, for security reasons, SerializedLayout is deprecated and no +Note that subsequent to the 2.9.0 release, for security reasons, SerializedLayout is deprecated and no longer used as default in the Socket and JMS appenders. SerializedLayout can still be used as before, but has to be specified explicitly. To retain old behaviour, you have to change configuration like: @@ -41,210 +44,55 @@ We do, however, discourage the use of SerializedLayout and recommend JsonLayout </Socket> </Appenders> -Note that subsequent to the 2.9 release, for security reasons, Log4j does not process DTD in XML files. +Note that subsequent to the 2.9.0 release, for security reasons, Log4j does not process DTD in XML files. If you used DTD for including snippets, you have to use XInclude or Composite Configuration instead. -The Log4j 2.9.0 API, as well as many core components, maintains binary compatibility with previous releases. +The Log4j 2.9.1 API, as well as many core components, maintains binary compatibility with previous releases. -## GA Release 2.9.0 +## GA Release 2.9.1 Changes in this version include: -### New Features -* [LOG4J2-2008](https://issues.apache.org/jira/browse/LOG4J2-2008): -Support printing multiple StructuredData elements in RFC5424Layout. -* [LOG4J2-1986](https://issues.apache.org/jira/browse/LOG4J2-1986): -Public API for parsing the output from JsonLayout/XmlLayout/YamlLayout into a LogEvent. -* [LOG4J2-1981](https://issues.apache.org/jira/browse/LOG4J2-1981): -JsonLayout, XmlLayout and YamlLayout support 0-byte termination of log events. -* [LOG4J2-1864](https://issues.apache.org/jira/browse/LOG4J2-1864): -Support capped collections for MongoDb appender. Thanks to Matthias Kappeller. -* [LOG4J2-1813](https://issues.apache.org/jira/browse/LOG4J2-1813): -Log4j2 will now print all internal logging to the console if system property `log4j2.debug` is defined with any value (or no value). -* [LOG4J2-1766](https://issues.apache.org/jira/browse/LOG4J2-1766): -Temporary compress directory during rollover (#88). Thanks to Pierrick HYMBERT. -* [LOG4J2-1814](https://issues.apache.org/jira/browse/LOG4J2-1814): -Added wrapper classes CustomLoggerGenerator and ExtendedLoggerGenerator to avoid class name with a dollar ($) character which has special meaning in many *nix command line environments. -* [LOG4J2-1884](https://issues.apache.org/jira/browse/LOG4J2-1884): -Added process ID (pid) pattern converter. -* [LOG4J2-1699](https://issues.apache.org/jira/browse/LOG4J2-1699): -Configurable Log File Permissions with PosixFilePermission. Thanks to Demetrios Dimatos, Pierrick HYMBERT. -* [LOG4J2-1945](https://issues.apache.org/jira/browse/LOG4J2-1945): -Generate source jas for all test jars. -* [LOG4J2-1934](https://issues.apache.org/jira/browse/LOG4J2-1934): -JMS Appender does not know how to recover from a broken connection. -* [LOG4J2-1955](https://issues.apache.org/jira/browse/LOG4J2-1955): -JMS Appender should be able connect to a broker (later) even it is not present at configuration time. -* [LOG4J2-1874](https://issues.apache.org/jira/browse/LOG4J2-1874): -Added methods ::writeBytes(ByteBuffer) and ::writeBytes(byte[], int, int) to ByteBufferDestination interface and use these methods in TextEncoderHelper where possible to prepare for future enhancements to reduce lock contention. Thanks to Roman Leventov. -* [LOG4J2-1442](https://issues.apache.org/jira/browse/LOG4J2-1442): -Generic HTTP appender. -* [LOG4J2-1935](https://issues.apache.org/jira/browse/LOG4J2-1935): -Add with(String, primitive) methods to org.apache.logging.log4j.message.MapMessage. -* [LOG4J2-1930](https://issues.apache.org/jira/browse/LOG4J2-1930): -Add forEach() methods to org.apache.logging.log4j.message.MapMessage. -* [LOG4J2-1932](https://issues.apache.org/jira/browse/LOG4J2-1932): -Add containsKey() methods to org.apache.logging.log4j.message.MapMessage. -* [LOG4J2-1854](https://issues.apache.org/jira/browse/LOG4J2-1854): -Support null byte delimiter in GelfLayout. Thanks to Xavier Jodoin. -* [LOG4J2-1359](https://issues.apache.org/jira/browse/LOG4J2-1359): -Add support for Java 9 StackWalker. -* [LOG4J2-1880](https://issues.apache.org/jira/browse/LOG4J2-1880): -Warn when a configuration file for an inactive ConfigurationFactory is found. -* [LOG4J2-1855](https://issues.apache.org/jira/browse/LOG4J2-1855): -Add an optional random delay in TimeBasedTriggeringPolicy Thanks to Anthony Maire. -* [LOG4J2-1860](https://issues.apache.org/jira/browse/LOG4J2-1860): -Shortcut to add Property and KeyValuePair component in ConfigurationBuilder. -* [LOG4J2-1294](https://issues.apache.org/jira/browse/LOG4J2-1294): -The JMS Appender should use a JMS MapMessage for a Log4j MapMessage. ### Fixed Bugs -* [LOG4J2-1833](https://issues.apache.org/jira/browse/LOG4J2-1833): -Prevent NullPointerException when a file name is specified with the DirectWriteRolloverStrategy. -* [LOG4J2-2018](https://issues.apache.org/jira/browse/LOG4J2-2018): -Fix incorrect documentation for LoggerNameLevelRewritePolicy. -* [LOG4J2-922](https://issues.apache.org/jira/browse/LOG4J2-922): -Parameter of mdcId in SyslogAppender has no default value. Thanks to angus.aqlu, Paul Burrowes. -* [LOG4J2-2001](https://issues.apache.org/jira/browse/LOG4J2-2001): -StyleConverter.newInstance argument validation is incorrect. Thanks to Paul Burrowes. -* [LOG4J2-1999](https://issues.apache.org/jira/browse/LOG4J2-1999): -HighlightConverter converts all unrecognized levels to DEBUG. Thanks to Paul Burrowes. -* [LOG4J2-2013](https://issues.apache.org/jira/browse/LOG4J2-2013): -SslSocketManager does not apply SSLContext on TCP reconnect. Thanks to Taylor Patton, Gary Gregory. -* [LOG4J2-2016](https://issues.apache.org/jira/browse/LOG4J2-2016): -Mark FileRenameAction as successful when using alternative ways to move files. Thanks to Benjamin Jaton. -* [LOG4J2-2012](https://issues.apache.org/jira/browse/LOG4J2-2012): -No compression when using a separate drive in Linux. Thanks to Benjamin Jaton. -* [LOG4J2-1888](https://issues.apache.org/jira/browse/LOG4J2-1888): -Log4j throws a java.nio.charset.UnsupportedCharsetException: cp65001. Thanks to Misagh Moayyed. -* [LOG4J2-1990](https://issues.apache.org/jira/browse/LOG4J2-1990): -ConcurrentModificationException logging a parameter of type Map. Thanks to Philippe Mouawad. -* [LOG4J2-1311](https://issues.apache.org/jira/browse/LOG4J2-1311): -SocketAppender will lose several events after re-connection to server. Thanks to Xibing Liang. -* [LOG4J2-1977](https://issues.apache.org/jira/browse/LOG4J2-1977): -Consider the StringBuilder's capacity instead of content length when trimming. Thanks to Jerry xnslong. -* [LOG4J2-1971](https://issues.apache.org/jira/browse/LOG4J2-1971): -Register log4j-core as an OSGi service. Skip tests for LOG4J2-1766 on MacOS. Use group "staff" for LOG4J2-1699 test on MacOS. -* [LOG4J2-1994](https://issues.apache.org/jira/browse/LOG4J2-1994): -TcpSocketServer does not close accepted Sockets. -* [LOG4J2-1987](https://issues.apache.org/jira/browse/LOG4J2-1987): -Log4J JUL Bridge and RMI Security Manager causes access denied ("java.util.logging.LoggingPermission" "control") Thanks to Andreas Felder. -* [LOG4J2-1982](https://issues.apache.org/jira/browse/LOG4J2-1982): -Log4j-config.xsd only allows one AppenderRef element for each Logger element. Thanks to Christoph Lembeck. -* [LOG4J2-1985](https://issues.apache.org/jira/browse/LOG4J2-1985): -Fix default buffer size to match documentation (from 8102 to 8192 a.k.a. 8KB.) Thanks to Kenneth McFarland. -* [LOG4J2-1912](https://issues.apache.org/jira/browse/LOG4J2-1912): -CompositeConfiguration logs warning "Unable to determine URI for configuration." However, the reconfiguration is completed. Thanks to R Ri. -* [LOG4J2-1964](https://issues.apache.org/jira/browse/LOG4J2-1964): -Dynamic reconfiguration does not work for filePattern of RollingFile. Thanks to Pierrick HYMBERT. -* [LOG4J2-1961](https://issues.apache.org/jira/browse/LOG4J2-1961): -Reconfigure breaks DirectWriteRolloverStrategy. Thanks to Christian Vent. -* [LOG4J2-1943](https://issues.apache.org/jira/browse/LOG4J2-1943): -The eventPrefix attribute was being ignored in the RFC5424Layout. -* [LOG4J2-1953](https://issues.apache.org/jira/browse/LOG4J2-1953): -JndiManager is not released when the JmsAppender builder catches an exception trying to build itself. -* [LOG4J2-1911](https://issues.apache.org/jira/browse/LOG4J2-1911): -Improve the documentation of the DynamicThresholdFilter. -* [LOG4J2-1929](https://issues.apache.org/jira/browse/LOG4J2-1929): -EOFException with FormattedMessage. Thanks to Borys Sokolov. -* [LOG4J2-1948](https://issues.apache.org/jira/browse/LOG4J2-1948): -Trim levels read from properties file to remove trailing spaces. Thanks to Michael Lück. -* [LOG4J2-1971](https://issues.apache.org/jira/browse/LOG4J2-1971): -ClassCastException: org.eclipse.osgi.internal.loader.SystemBundleLoader$1 cannot be cast to java.lang.ClassLoader. Thanks to liwenxian2017. -* [LOG4J2-1876](https://issues.apache.org/jira/browse/LOG4J2-1876): -More reliable checking for runtime dependencies. -* [LOG4J2-1867](https://issues.apache.org/jira/browse/LOG4J2-1867): -Fix configuration documentation. -* [LOG4J2-1858](https://issues.apache.org/jira/browse/LOG4J2-1858): -Ensure the ThreadLocal StringBuilder in ParameterizedMessage won't hold excessively much memory after logging a long message. -* [LOG4J2-1885](https://issues.apache.org/jira/browse/LOG4J2-1885): -Fix documentation about default additivity value for loggers. -* [LOG4J2-1920](https://issues.apache.org/jira/browse/LOG4J2-1920): -ScriptEngineManager is not available in Android and causes a NoClassDefFoundError. Thanks to Ajitha. -* [LOG4J2-1989](https://issues.apache.org/jira/browse/LOG4J2-1989): -Clarify Javadoc for AbstractTriggeringPolicy. Thanks to Kenneth McFarland. -* [LOG4J2-1993](https://issues.apache.org/jira/browse/LOG4J2-1993): -Fix compiler warnings in LoggerConfigTest. Thanks to Kenneth McFarland. +* [LOG4J2-1988](https://issues.apache.org/jira/browse/LOG4J2-1988): +Prevent ConcurrentModificationException with AsyncLoggerConfig. +* [LOG4J2-1914](https://issues.apache.org/jira/browse/LOG4J2-1914): +Prevent ConcurrentModificationException with AsyncLoggerConfig. +* [LOG4J2-2048](https://issues.apache.org/jira/browse/LOG4J2-2048): +Increase default queue size for AsyncAppender from 128 to 1024. +* [LOG4J2-2035](https://issues.apache.org/jira/browse/LOG4J2-2035): +Fix documentation to clarify disruptor-3.3.4 is now required for async loggers: disruptor-3.3.3 was never released. +* [LOG4J2-2030](https://issues.apache.org/jira/browse/LOG4J2-2030): +Inspect all known ClassLoaders to locate the service provider. +* [LOG4J2-2028](https://issues.apache.org/jira/browse/LOG4J2-2028): +Java 9 StackLocator was not properly skipping the initial stack frames. Thanks to Jason Tedor. +* [LOG4J2-2026](https://issues.apache.org/jira/browse/LOG4J2-2026): +java.lang.AbstractMethodError: javax.xml.parsers.DocumentBuilderFactory.setFeature(). Thanks to Leon Finker. +* [LOG4J2-2029](https://issues.apache.org/jira/browse/LOG4J2-2029): +Marker examples should not use deprecated flow APIs. Thanks to Fabrizio Cucci. +* [LOG4J2-1936](https://issues.apache.org/jira/browse/LOG4J2-1936): +ClassNotFoundException when making all loggers asynchronous under OSGi environment. Thanks to Helber Belmiro. ### Changes -* [LOG4J2-1928](https://issues.apache.org/jira/browse/LOG4J2-1928): -Add support for DirectWriteRolloverStrategy to RollingRandomAcessFileAppender. -* [LOG4J2-2022](https://issues.apache.org/jira/browse/LOG4J2-2022): -RFC5424Layout now prints the process id. -* [LOG4J2-2020](https://issues.apache.org/jira/browse/LOG4J2-2020): -Remove default layout from KafkaAppender. * [LOG4J2-2023](https://issues.apache.org/jira/browse/LOG4J2-2023): Use a class' canonical name instead of name to create its logger name. -* [LOG4J2-2015](https://issues.apache.org/jira/browse/LOG4J2-2015): -Allow KeyStoreConfiguration and TrustStoreConfiguration to find files as resources. -* [LOG4J2-2011](https://issues.apache.org/jira/browse/LOG4J2-2011): -Replace JCommander command line parser with picocli to let users run Log4j2 utility applications without requiring an external dependency. -* [LOG4J2-1984](https://issues.apache.org/jira/browse/LOG4J2-1984): -Allow maxLength of StructuredData to be specified by the user. -* [LOG4J2-1071](https://issues.apache.org/jira/browse/LOG4J2-1071): -Allow for bufferSize=0 in SMTP appender. Thanks to Ben Ludkiewicz, Benjamin Jaton. -* [LOG4J2-1261](https://issues.apache.org/jira/browse/LOG4J2-1261): -Async Loggers no longer use deprecated LMAX Disruptor APIs. (Disruptor-3.3.3 or higher is now required.) -* [LOG4J2-1908](https://issues.apache.org/jira/browse/LOG4J2-1908): -Improved error message when misconfigured with multiple incompatible appenders targeting same file. -* [LOG4J2-1954](https://issues.apache.org/jira/browse/LOG4J2-1954): -Configurations with multiple root loggers now fail loudly. -* [LOG4J2-1958](https://issues.apache.org/jira/browse/LOG4J2-1958): -Deprecate SerializedLayout and remove it as default. -* [LOG4J2-1959](https://issues.apache.org/jira/browse/LOG4J2-1959): -Disable DTD processing in XML configuration files. -* [LOG4J2-1950](https://issues.apache.org/jira/browse/LOG4J2-1950): -Fix docker build with jdk9 requirements (#84). Thanks to Pierrick HYMBERT. -* [LOG4J2-1801](https://issues.apache.org/jira/browse/LOG4J2-1801): -Add more detail to WARN "Ignoring log event" messages printed to the console after log4j was shut down. -* [LOG4J2-1926](https://issues.apache.org/jira/browse/LOG4J2-1926): -Facilitate log4j use in Android applications: remove dependency on RMI and Management APIs from log4j-api. -* [LOG4J2-1956](https://issues.apache.org/jira/browse/LOG4J2-1956): -JMS Appender broker password should be a char[], not a String. -* [LOG4J2-1917](https://issues.apache.org/jira/browse/LOG4J2-1917): -Support using java.util.ServiceLoader to locate Log4j 2 API providers. -* [LOG4J2-1966](https://issues.apache.org/jira/browse/LOG4J2-1966): -Include separator option of PatternLayout in manual (and other updates). Thanks to M Sazzadul Hoque. -* [LOG4J2-1851](https://issues.apache.org/jira/browse/LOG4J2-1851): -Move server components from log4j-core to new log4-server module. -* [LOG4J2-1991](https://issues.apache.org/jira/browse/LOG4J2-1991): -Refactor SimpleMessage to be concise and clear (#100) Thanks to . -* [LOG4J2-2017](https://issues.apache.org/jira/browse/LOG4J2-2017): -Update Jackson from 2.8.9 to 2.9.0. -* [LOG4J2-1868](https://issues.apache.org/jira/browse/LOG4J2-1868): -Update ZeroMQ's JeroMQ from 0.3.6 to 0.4.0. -* [LOG4J2-1960](https://issues.apache.org/jira/browse/LOG4J2-1960): -Update ZeroMQ's JeroMQ from 0.4.0 to 0.4.1. -* [LOG4J2-1974](https://issues.apache.org/jira/browse/LOG4J2-1974): -Update ZeroMQ's JeroMQ from 0.4.1 to 0.4.2. -* [LOG4J2-1869](https://issues.apache.org/jira/browse/LOG4J2-1869): -Update Kafka client from 0.10.1.1 to 0.10.2.0 -* [LOG4J2-1962](https://issues.apache.org/jira/browse/LOG4J2-1962): -Update Kafka client from 0.10.2.0 to 0.11.0.0 -* [LOG4J2-1872](https://issues.apache.org/jira/browse/LOG4J2-1872): -Update JavaMail from 1.5.5 to 1.5.6. -* [LOG4J2-1879](https://issues.apache.org/jira/browse/LOG4J2-1879): -Update JAnsi from 1.14 to 1.15. -* [LOG4J2-1877](https://issues.apache.org/jira/browse/LOG4J2-1877): -Missing documentation for Max index limit in DefaultRolloverStrategy. Thanks to Chandra Tungathurthi. -* [LOG4J2-1899](https://issues.apache.org/jira/browse/LOG4J2-1899): -Add missing getters to classes in package org.apache.logging.log4j.core.net.ssl. -* [LOG4J2-1900](https://issues.apache.org/jira/browse/LOG4J2-1900): -Update JAnsi from 1.15 to 1.16. -* [LOG4J2-](https://issues.apache.org/jira/browse/LOG4J2-): -Update SLF4J from 1.7.24 to 1.7.25. -* [LOG4J2-1938](https://issues.apache.org/jira/browse/LOG4J2-1938): -Update Jackson from 2.8.7 to 2.8.9. -* [LOG4J2-1970](https://issues.apache.org/jira/browse/LOG4J2-1970): -Update HdrHistogram from 2.1.8 to 2.1.9. -* [LOG4J2-1975](https://issues.apache.org/jira/browse/LOG4J2-1975): -Update javax.persistence from 2.1.0 to 2.1.1. -* [LOG4J2-1976](https://issues.apache.org/jira/browse/LOG4J2-1976): -Update org.osgi.core from 4.3.1 to 6.0.0. +* [LOG4J2-2043](https://issues.apache.org/jira/browse/LOG4J2-2043): +Update Jackson from 2.9.0 to 2.9.1 (fix for Java 9.) +* [LOG4J2-2044](https://issues.apache.org/jira/browse/LOG4J2-2044): +Update Apache Commons CSV from 1.4 to 1.5. +* [LOG4J2-2045](https://issues.apache.org/jira/browse/LOG4J2-2045): +Update javax.mail from 1.5.6 to 1.6.0. +* [LOG4J2-2046](https://issues.apache.org/jira/browse/LOG4J2-2046): +Update Apache Commons Compress from 1.13 to 1.14. +* [LOG4J2-2047](https://issues.apache.org/jira/browse/LOG4J2-2047): +Update Cassandra driver from 3.1.0 to 3.1.4. +* [LOG4J2-2049](https://issues.apache.org/jira/browse/LOG4J2-2049): +Update Apache Kafka Client from 0.11.0.0 to 0.11.0.1. --- -Apache Log4j 2.9.0 requires a minimum of Java 7 to build and run. Log4j 2.3 was the +Apache Log4j 2.9.1 requires a minimum of Java 7 to build and run. Log4j 2.3 was the last release that supported Java 6. Basic compatibility with Log4j 1.x is provided through the log4j-1.2-api component, however it http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6621be5a/pom.xml ---------------------------------------------------------------------- diff --git a/pom.xml b/pom.xml index 242ba3a..65c3114 100644 --- a/pom.xml +++ b/pom.xml @@ -170,7 +170,7 @@ <properties> <!-- make sure to update these for each release! --> <log4jParentDir>${basedir}</log4jParentDir> - <Log4jReleaseVersion>2.9.0</Log4jReleaseVersion> + <Log4jReleaseVersion>2.9.1</Log4jReleaseVersion> <Log4jReleaseManager>Ralph Goers</Log4jReleaseManager> <Log4jReleaseKey>B3D8E1BA</Log4jReleaseKey> <!--<Log4jReleaseManager>Matt Sicker</Log4jReleaseManager> --> http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6621be5a/src/changes/announcement.vm ---------------------------------------------------------------------- diff --git a/src/changes/announcement.vm b/src/changes/announcement.vm index 4a48f8e..98f8ab4 100644 --- a/src/changes/announcement.vm +++ b/src/changes/announcement.vm @@ -47,15 +47,18 @@ property substitution using Lookups, multiple patterns on a PatternLayout and as Loggers. Another notable Log4j 2 feature is the ability to be "garbage-free" (avoid allocating temporary objects) while logging. In addition, Log4j 2 will not lose events while reconfiguring. -This release contains the first support of Java 9 as well as bugfixes and minor -enhancements. The Log4j API was modified to use java.util.ServiceLoader to locate Log4j implementations, +This release contains bugfixes and minor enhancements. + +As of Log4j 2.9.0, the Log4j API was modified to use java.util.ServiceLoader to locate Log4j implementations, although the former binding mechanism is still supported. The Log4j jar is now a multi-release jar -to provide implementations of the Java 9 specific classes. Multi-release jars are not supported by +to provide implementations of Java 9 specific classes. Multi-release jars are not supported by the OSGi specification so OSGi modules will not be able to take advantage of these implementations but will not lose functionality as they will fall back to the implementations used in Java 7 and 8. -More details on the new features and fixes are itemized below. +More details on the new features and fixes are itemized below. Note that some tools are not compatible +with multi-release jars and may fail trying to process class files in the META-INF/versions/9 folder. +Those errors should be reported to the tool vendor. -Note that subsequent to the 2.9 release, for security reasons, SerializedLayout is deprecated and no +Note that subsequent to the 2.9.0 release, for security reasons, SerializedLayout is deprecated and no longer used as default in the Socket and JMS appenders. SerializedLayout can still be used as before, but has to be specified explicitly. To retain old behaviour, you have to change configuration like: @@ -79,7 +82,7 @@ We do, however, discourage the use of SerializedLayout and recommend JsonLayout </Socket> </Appenders> -Note that subsequent to the 2.9 release, for security reasons, Log4j does not process DTD in XML files. +Note that subsequent to the 2.9.0 release, for security reasons, Log4j does not process DTD in XML files. If you used DTD for including snippets, you have to use XInclude or Composite Configuration instead. The Log4j ${relVersion} API, as well as many core components, maintains binary compatibility with previous releases. http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6621be5a/src/changes/changes.xml ---------------------------------------------------------------------- diff --git a/src/changes/changes.xml b/src/changes/changes.xml index d9985ec..9914edc 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -30,7 +30,7 @@ - "update" - Change - "remove" - Removed --> - <release version="2.9.1" date="2017-MM-DD" description="GA Release 2.9.1"> + <release version="2.9.1" date="2017-09-17" description="GA Release 2.9.1"> <action issue="LOG4J2-1988" dev="rpopma" type="fix"> Prevent ConcurrentModificationException with AsyncLoggerConfig. </action> http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6621be5a/src/site/resources/images/logo.png ---------------------------------------------------------------------- diff --git a/src/site/resources/images/logo.png b/src/site/resources/images/logo.png index 14316dc..1a850fc 100644 Binary files a/src/site/resources/images/logo.png and b/src/site/resources/images/logo.png differ http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6621be5a/src/site/resources/logo/logo-2.9.1.png ---------------------------------------------------------------------- diff --git a/src/site/resources/logo/logo-2.9.1.png b/src/site/resources/logo/logo-2.9.1.png new file mode 100644 index 0000000..1a850fc Binary files /dev/null and b/src/site/resources/logo/logo-2.9.1.png differ http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/6621be5a/src/site/resources/logo/logo-2.9.1.xcf ---------------------------------------------------------------------- diff --git a/src/site/resources/logo/logo-2.9.1.xcf b/src/site/resources/logo/logo-2.9.1.xcf new file mode 100644 index 0000000..c18bae0 Binary files /dev/null and b/src/site/resources/logo/logo-2.9.1.xcf differ
