You are viewing a plain text version of this content. The canonical link for it is here.

Posted to commits@logging.apache.org by rg...@apache.org on 2012/08/24 02:26:34 UTC

svn commit: r1376801 - /logging/log4j/log4j2/trunk/src/site/xdoc/manual/messages.xml

Author: rgoers
Date: Fri Aug 24 00:26:34 2012
New Revision: 1376801

URL: http://svn.apache.org/viewvc?rev=1376801&view=rev
Log:
Add documentation on StringFormattedMessage

Modified:
    logging/log4j/log4j2/trunk/src/site/xdoc/manual/messages.xml

Modified: logging/log4j/log4j2/trunk/src/site/xdoc/manual/messages.xml
URL: http://svn.apache.org/viewvc/logging/log4j/log4j2/trunk/src/site/xdoc/manual/messages.xml?rev=1376801&r1=1376800&r2=1376801&view=diff
==============================================================================
--- logging/log4j/log4j2/trunk/src/site/xdoc/manual/messages.xml (original)
+++ logging/log4j/log4j2/trunk/src/site/xdoc/manual/messages.xml Fri Aug 24 00:26:34 2012
@@ -221,6 +221,14 @@
         <p>
           SimpleMessage contains a String that requires no formatting.
         </p>
+      <a name="StringFormattedMessage"/>
+      <h4>StringFormattedMessage</h4>
+        <p>
+          <a href="../log4j2-api/apidocs/org/apache/logging/log4j/message/StringFormattedMessage.html">StringFormattedMessage</a>
+          handles messages that use a <a href="http://docs.oracle.com/javase/6/docs/api/java/util/Formatter.html#syntax">conversion format</a>
+          that is compliant with <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html#format(java.lang.String, java.lang.Object...)">java.lang.String.format()</a>.
+          While this Message has more flexibility than ParameterizedMessage, it is also 5 to 10 times slower.
+        </p>
       <a name="StructuredDataMessage"/>
       <h4>StructuredDataMessage</h4>
         <p>