[LOGCXX-252] Add documentation for use of operator<< in logging requests

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 0.10.0
• Fix Version/s: 0.10.0
• Component/s: Documentation
• Assignee: Curt Arnold
• Reporter: Curt Arnold
• Created: 19/Mar/08 03:40
• Updated: 19/Mar/08 03:42
• Resolved: 19/Mar/08 03:42

Description

On Mar 18, 2008, at 9:09 AM, Josh Kelley wrote:

I saw that I can use the << operator within the LOG4CXX_DEBUG, etc.
macros; e.g.:

LOG4CXX_DEBUG(logger, "Read " << path << " and got " << out);

This seems very convenient (and a whole lot more convenient than
formatting strings myself or having to use something like
boost::format for every log statement), but as far as I can tell, it's
undocumented. Is this use of operator<< officially supported, or is
it an implementation detail that I should not be relying upon?

If it is supported, then can I add a wiki page about it? If it's not
supported, then is there a recommended way of doing formatted logging?

Thanks.

Josh Kelley