Repository: logging-log4j2
Updated Branches:
  refs/heads/master 525d3d633 -> 242856ce7


Update Javadoc and changes.xml


Project: http://git-wip-us.apache.org/repos/asf/logging-log4j2/repo
Commit: http://git-wip-us.apache.org/repos/asf/logging-log4j2/commit/242856ce
Tree: http://git-wip-us.apache.org/repos/asf/logging-log4j2/tree/242856ce
Diff: http://git-wip-us.apache.org/repos/asf/logging-log4j2/diff/242856ce

Branch: refs/heads/master
Commit: 242856ce78efbb42edc5ac18ac3974edf1b74bdc
Parents: 525d3d6
Author: Mikael StÃ¥ldal <[email protected]>
Authored: Sun Jun 12 13:41:38 2016 +0200
Committer: Mikael StÃ¥ldal <[email protected]>
Committed: Sun Jun 12 13:41:38 2016 +0200

----------------------------------------------------------------------
 log4j-api/src/main/java/org/apache/logging/log4j/Logger.java | 8 +++++++-
 src/changes/changes.xml                                      | 3 +++
 2 files changed, 10 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/242856ce/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java
----------------------------------------------------------------------
diff --git a/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java 
b/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java
index 5885cc8..d851973 100644
--- a/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java
+++ b/log4j-api/src/main/java/org/apache/logging/log4j/Logger.java
@@ -1748,7 +1748,13 @@ public interface Logger {
     Level getLevel();
 
     /**
-     * Gets the message factory used to convert message Objects and Strings 
into actual log Messages.
+     * Gets the message factory used to convert message Objects and 
Strings/CharSequences into actual log Messages.
+     *
+     * Since version 2.6, Log4j internally uses message factories that 
implement the {@link MessageFactory2} interface.
+     * From version 2.6.2, the return type of this method was changed from 
{@link MessageFactory} to
+     * {@code <MF extends MessageFactory> MF}. The returned factory will 
always implement {@link MessageFactory2},
+     * but the return type of this method could not be changed to {@link 
MessageFactory2} without breaking binary
+     * compatibility.
      *
      * @return the message factory, as an instance of {@link MessageFactory2}
      */

http://git-wip-us.apache.org/repos/asf/logging-log4j2/blob/242856ce/src/changes/changes.xml
----------------------------------------------------------------------
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 8e41680..0924f00 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -24,6 +24,9 @@
   </properties>
   <body>
     <release version="2.6.2" date="2016-MM-DD" description="GA Release 2.6.2">
+      <action issue="LOG4J2-1418" dev="mikes" type="fix">
+        Provide MessageFactory2 to custom Logger implementations.
+      </action>
       <action issue="LOG4J2-1420" dev="rgoers" type="fix">
         RollingRandomAccessFileManager was not properly rolling over on 
startup and was getting a NullPointerException.
       </action>

Reply via email to