Author: tschoening
Date: Sun Jan 19 17:37:10 2014
New Revision: 1559535
URL: http://svn.apache.org/r1559535
Log:
Documented C (class) and M (method) log format keywords.
Modified:
incubator/log4cxx/trunk/src/changes/changes.xml
incubator/log4cxx/trunk/src/main/include/log4cxx/patternlayout.h
Modified: incubator/log4cxx/trunk/src/changes/changes.xml
URL:
http://svn.apache.org/viewvc/incubator/log4cxx/trunk/src/changes/changes.xml?rev=1559535&r1=1559534&r2=1559535&view=diff
==============================================================================
--- incubator/log4cxx/trunk/src/changes/changes.xml (original)
+++ incubator/log4cxx/trunk/src/changes/changes.xml Sun Jan 19 17:37:10 2014
@@ -65,6 +65,7 @@
<action issue="LOGCXX-420" type="fix">Possible
out_of_range exception for millisecond formats in CachedDateFormat</action>
<action type="change">Behavior of
StringHelper::startsWith and endsWith synced</action>
+ <action type="change">Documented C (class) and M
(method) log format keywords.</action>
</release>
<release version="0.10.0" date="2008-04-03" description="First
Apache release">
<action issue="LOGCXX-2" type="fix">logger.h includes
config.h</action>
Modified: incubator/log4cxx/trunk/src/main/include/log4cxx/patternlayout.h
URL:
http://svn.apache.org/viewvc/incubator/log4cxx/trunk/src/main/include/log4cxx/patternlayout.h?rev=1559535&r1=1559534&r2=1559535&view=diff
==============================================================================
--- incubator/log4cxx/trunk/src/main/include/log4cxx/patternlayout.h (original)
+++ incubator/log4cxx/trunk/src/main/include/log4cxx/patternlayout.h Sun Jan 19
17:37:10 2014
@@ -106,6 +106,29 @@ namespace log4cxx
</td>
</tr>
+ <tr>
+ <td align="center">
+ <b>C</b>
+ <p><b>class</b></p>
+ </td>
+
+ <td>
+ Used to output the class of the issuer of the logging event if the
+ compiler used supports a macro to retrieve the method of the
+ currently compiled line and if the LOG4CXX_TRACE-like macros are
+ used to issue a logging request. In this case the macro LOG4CXX_*
+ is expanded at compile time to generate location info of the
+ logging event and adds the method name, besides file and line, if
+ available. In most cases the provided method contains the classname
+ and can therefore be retrieved form the location info as needed.
+
+ <p>
+ Currently supported compilers are those from Microsoft, GNU-C and
+ Borland.
+ </p>
+ </td>
+ </tr>
+
<tr> <td align=center><b>d</b></td> <td>Used to output the date of
the logging event. The date conversion specifier may be
followed by a set of braces containing a
@@ -150,6 +173,30 @@ namespace log4cxx
</tr>
<tr>
+ <td align="center">
+ <b>M</b>
+ <p><b>method</b></p>
+ </td>
+
+ <td>
+ Used to output the method of the issuer of the logging event if the
+ compiler used supports a macro to retrieve the method of the
+ currently compiled line and if the LOG4CXX_TRACE-like macros are
+ used to issue a logging request. In this case the macro LOG4CXX_*
+ is expanded at compile time to generate location info of the
+ logging event and adds the method name, besides file and line, if
+ available. In most cases the provided method contains the classname
+ which is ignored in every attempt to retrieve the method from the
+ location info.
+
+ <p>
+ Currently supported compilers are those from Microsoft, GNU-C and
+ Borland.
+ </p>
+ </td>
+ </tr>
+
+ <tr>
<td align=center><b>n</b></td>
<td>Outputs the platform dependent line separator character or
@@ -336,11 +383,13 @@ namespace log4cxx
/**
* Pattern converters.
*/
+ LOG4CXX_LIST_DEF(LoggingEventPatternConverterList,
log4cxx::pattern::LoggingEventPatternConverterPtr);
LoggingEventPatternConverterList patternConverters;
/**
* Field widths and alignment corresponding to pattern
converters.
*/
+ LOG4CXX_LIST_DEF(FormattingInfoList,
log4cxx::pattern::FormattingInfoPtr);
FormattingInfoList patternFields;
