From general-return-1256-apmail-logging-general-archive=logging.apache.org@logging.apache.org Fri Mar 28 18:38:00 2008 Return-Path: Delivered-To: apmail-logging-general-archive@www.apache.org Received: (qmail 21110 invoked from network); 28 Mar 2008 18:38:00 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 28 Mar 2008 18:38:00 -0000 Received: (qmail 25909 invoked by uid 500); 28 Mar 2008 18:37:58 -0000 Delivered-To: apmail-logging-general-archive@logging.apache.org Received: (qmail 25847 invoked by uid 500); 28 Mar 2008 18:37:57 -0000 Mailing-List: contact general-help@logging.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: "Logging General" List-Id: Delivered-To: mailing list general@logging.apache.org Received: (qmail 25815 invoked by uid 99); 28 Mar 2008 18:37:57 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 28 Mar 2008 11:37:57 -0700 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 28 Mar 2008 18:37:13 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 91CC01A986A; Fri, 28 Mar 2008 11:37:06 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r642326 [14/14] - in /logging/site/trunk/docs/log4cxx: ./ apidocs/ building/ stylesheets/ Date: Fri, 28 Mar 2008 18:36:35 -0000 To: general@logging.apache.org From: carnold@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20080328183706.91CC01A986A@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Modified: logging/site/trunk/docs/log4cxx/dependencies.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/dependencies.html?rev=642326&r1=642325&r2=642326&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/dependencies.html (original) +++ logging/site/trunk/docs/log4cxx/dependencies.html Fri Mar 28 11:36:20 2008 @@ -59,7 +59,7 @@
- Last Published: 2008-02-23 + Last Published: 2008-03-28 | Apache > @@ -255,13 +255,13 @@

Logging framework for C++.

-

http://logging.apache.org:80/log4cxx +

http://logging.apache.org:80/log4cxx

Log4j

Log4j

-

http://logging.apache.org/log4j/docs/ +

http://logging.apache.org/log4j/docs/

Modified: logging/site/trunk/docs/log4cxx/download.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/download.html?rev=642326&r1=642325&r2=642326&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/download.html (original) +++ logging/site/trunk/docs/log4cxx/download.html Fri Mar 28 11:36:20 2008 @@ -59,7 +59,7 @@
- Last Published: 2008-02-23 + Last Published: 2008-03-28 | Apache > @@ -217,7 +217,7 @@

Download Apache log4cxx 0.10.0

-

Apache log4cxx 0.10.0 is distributed under the Apache License, version 2.0 +

Apache log4cxx 0.10.0 is distributed under the Apache License, version 2.0 .

The link in the Mirrors column should display a list of available mirrors with a default selection based on your inferred location. If you do not see that page, try a different browser. The checksum and signature are links to the originals on the main distribution server.

@@ -226,27 +226,27 @@ - - - - - -
Signature
Apache log4cxx 0.10.0 (tar.gz) apache-log4cxx-0.10.0.tar.gz + apache-log4cxx-0.10.0.tar.gz apache-log4cxx-0.10.0.tar.gz.md5 + apache-log4cxx-0.10.0.tar.gz.md5 apache-log4cxx-0.10.0.tar.gz.asc + apache-log4cxx-0.10.0.tar.gz.asc
Apache log4cxx 0.10.0 (zip) apache-log4cxx-0.10.0.zip + apache-log4cxx-0.10.0.zip apache-log4cxx-0.10.0.zip.md5 + apache-log4cxx-0.10.0.zip.md5 apache-log4cxx-0.10.0.zip.asc + apache-log4cxx-0.10.0.zip.asc
-

Please read Verifying Apache HTTP Server Releases +

Please read Verifying Apache HTTP Server Releases for more information on why you should verify our releases.

Previous Releases

-

All previous releases of Apache log4cxx can be found in the archive repository +

All previous releases of Apache log4cxx can be found in the archive repository .

Modified: logging/site/trunk/docs/log4cxx/faq.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/faq.html?rev=642326&r1=642325&r2=642326&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/faq.html (original) +++ logging/site/trunk/docs/log4cxx/faq.html Fri Mar 28 11:36:20 2008 @@ -59,7 +59,7 @@
- Last Published: 2008-02-23 + Last Published: 2008-03-28 | Apache > Modified: logging/site/trunk/docs/log4cxx/index.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/index.html?rev=642326&r1=642325&r2=642326&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/index.html (original) +++ logging/site/trunk/docs/log4cxx/index.html Fri Mar 28 11:36:20 2008 @@ -59,7 +59,7 @@
- Last Published: 2008-02-23 + Last Published: 2008-03-28 | Apache > @@ -221,16 +221,16 @@

Introduction

Apache log4cxx is a logging framework for C++ patterned after -Apache log4j +Apache log4j . -Apache log4cxx uses Apache Portable Runtime +Apache log4cxx uses Apache Portable Runtime for most platform-specific code and should be usable on any platform supported by APR. Apache log4cxx is licensed under the -Apache License +Apache License , an open source license certified by the -Open Source Initiative +Open Source Initiative .

Almost every large application includes its own logging or tracing @@ -311,14 +311,16 @@ } // // Use these macros instead of calling Logger methods directly. -// Macros will accept char and wchar_t pointers and strings. +// Macros will handle char or wchar_t pointers or strings +// or most right-hand side expressions of an +// std::basic_string::operator<<. // -#define LOG4CXX_TRACE(logger, msg) ... -#define LOG4CXX_DEBUG(logger, msg) ... -#define LOG4CXX_INFO(logger, msg) ... -#define LOG4CXX_WARN(logger, msg) ... -#define LOG4CXX_ERROR(logger, msg) ... -#define LOG4CXX_FATAL(logger, msg) ... +#define LOG4CXX_TRACE(logger, expression) ... +#define LOG4CXX_DEBUG(logger, expression) ... +#define LOG4CXX_INFO(logger, expression) ... +#define LOG4CXX_WARN(logger, expression) ... +#define LOG4CXX_ERROR(logger, expression) ... +#define LOG4CXX_FATAL(logger, expression) ... @@ -461,17 +463,33 @@ and are assigned the levels Proot and Px respectively. The loggers X.Y and X.Y.Z inherits their level value from their nearest parent X -having an assigned level..

+having an assigned level.

Logging requests are made by invoking a method of a logger instance, preferrably through the use of LOG4CXX_INFO or similar -macros. Each request specifies the level of the logging request.

+macros which support short-circuiting if the threshold is not satisfied +and use of the insertion operator (<<) in the message parameter.

+

+ +
+   log4cxx::LoggerPtr logger(log4cxx::Logger::getLogger("com.foo"));
+   const char* region = "World";
+   LOG4CXX_INFO(logger, "Simple message text.");
+   LOG4CXX_INFO(logger, "Hello, " << region);
+   LOG4CXX_DEBUG(logger, L"Iteration " << i);
+   LOG4CXX_DEBUG(logger, "e^10 = " << std::scientific << exp(10.0));
+   //
+   //  Use a wchar_t first operand to force use of wchar_t based stream.    
+   //
+   LOG4CXX_WARN(logger, L"" << i << L" is the number of the iteration.");
+
+

A logging request is said to be enabled if its level is higher than or equal to the level of its logger. Otherwise, the request is said to be disabled. A logger without an assigned level will inherit one from the hierarchy. This rule is summarized below.

-
Basic Selection Rule +
Basic Selection Rule
A log request of level p in a logger with @@ -488,7 +506,7 @@ ordered. For the standard levels, we have TRACE < DEBUG < INFO < WARN < ERROR < FATAL.

Here is an example of this rule.

-

+
 
    // get a logger instance named "com.foo"
    log4cxx::LoggerPtr  logger(log4cxx::Logger::getLogger("com.foo"));
@@ -522,7 +540,7 @@
 always return a reference to the exact same logger object.

 
For example, in
 
-
+
@@ -587,7 +605,7 @@
  to false.
The rules governing appender additivity are summarized below.

-
    log4cxx::LoggerPtr x = log4cxx::Logger::getLogger("wombat");
    log4cxx::LoggerPtr y = log4cxx::Logger::getLogger("wombat");

 

 
 
Appender Additivity
+
Appender Additivity
 

 
The output of a log statement of logger C
  will
@@ -613,7 +631,7 @@
 

 

 
The table below shows an example:

-
Logger

+

@@ -622,7 +640,7 @@
 
-
+
@@ -630,32 +648,32 @@
         log4cxx::Logger::getRootLogger() method. There is no default appender
         attached to root.
-
+
-
+
-
+
-
+
-
+
@@ -699,7 +717,7 @@
 XML or in Java properties (key=value) format.
Let us give a taste of how this is done with the help of an
 imaginary application MyApp that uses log4cxx.

-
Logger

 Name 		
 Added

 Appenders		Output Targets
 Comment
 
root    
root    
 A1         
 not applicable 
 A1
 
x       
x       
 A-x1, A-x2 
 true 
 A1, A-x1, A-x2
 Appenders of "x" and root.
 
x.y     
x.y     
 none       
 true 
 A1, A-x1, A-x2
 Appenders of "x" and root.
 
x.y.z   
x.y.z   
 A-xyz1     
 true 
 A1, A-x1, A-x2, A-xyz1
 Appenders in "x.y.z", "x" and root.
 
security        
security        
 A-sec	   
 false
 A-sec
 No appender accumulation since the additivity flag is set to
         false.
 
security.access 
security.access 
 none 
  true 
  A-sec 
 
+
 #include "com/foo/bar.h"
 using namespace com::foo;
 
@@ -743,7 +761,7 @@
 class.

 
MyApp uses the Bar class defined in header
 file com/foo/bar.h.

-
+
 //  file com/foo/bar.h
 #include "log4cxx/logger.h"
 
@@ -793,7 +811,7 @@
 Fortunately, it is easy to modify MyApp so that the log
 output can be controlled at run-time. Here is a slightly modified
 version.

-
+
 // file MyApp2.cpp
 
 #include "com/foo/bar.h"
@@ -846,7 +864,7 @@
 set up logging accordingly.

 
Here is a sample configuration file that results in exactly same
 output as the previous BasicConfigurator based example.

-
+
 # Set root logger level to DEBUG and its only appender to A1.
 log4j.rootLogger=DEBUG, A1
 
@@ -864,7 +882,7 @@
 
Suppose we are no longer interested in seeing the output of any
 component belonging to the com::foo package. The following
 configuration file shows one possible way of achieving this.

-
+
 log4j.rootLogger=DEBUG, A1
 log4j.appender.A1=org.apache.log4j.ConsoleAppender
 log4j.appender.A1.layout=org.apache.log4j.PatternLayout
@@ -887,7 +905,7 @@
 logger level WARN. Consequently, doIt() method's log
 request is suppressed.

 
Here is another configuration file that uses multiple appenders.

-
+

-
-
-
-
-
@@ -242,7 +242,7 @@
 
-
@@ -250,19 +250,19 @@
 
-
-
-
-
-
-
@@ -270,7 +270,7 @@
 
-
@@ -278,7 +278,7 @@
 
-
 log4j.rootLogger=debug, stdout, R
 
 log4j.appender.stdout=org.apache.log4j.ConsoleAppender

Modified: logging/site/trunk/docs/log4cxx/issue-tracking.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/issue-tracking.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/issue-tracking.html (original)
+++ logging/site/trunk/docs/log4cxx/issue-tracking.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
   
     
             

-        Last Published: 2008-02-23
+        Last Published: 2008-03-28
                           |   
                 Apache
                 >
@@ -217,11 +217,11 @@
     

       

         
Overview

-This project uses Jira
+This project uses Jira
  a J2EE-based, issue tracking and project management application.

 
Issue Tracking

 
Issues, bugs, and feature requests should be submitted to the following issue tracking system for this project.

-
http://issues.apache.org/jira/
+
http://issues.apache.org/jira/
 

 

 


Modified: logging/site/trunk/docs/log4cxx/license.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/license.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/license.html (original)
+++ logging/site/trunk/docs/log4cxx/license.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
   
     
             

-        Last Published: 2008-02-23
+        Last Published: 2008-03-28
                           |   
                 Apache
                 >

Modified: logging/site/trunk/docs/log4cxx/mail-lists.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/mail-lists.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/mail-lists.html (original)
+++ logging/site/trunk/docs/log4cxx/mail-lists.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
   
     
             

-        Last Published: 2008-02-23
+        Last Published: 2008-03-28
                           |   
                 Apache
                 >
@@ -226,15 +226,15 @@
 
Other Archives
 

 
log4cxx-user : log4cxx usageSubscribe
+Subscribe
 Unsubscribe
+Unsubscribe
 Post
+Post
 mail-archives.apache.org
+mail-archives.apache.org
 markmail.org
+markmail.org
 
 

 
  
  
  marc.info
+marc.info
 
 

 
  
  
  dir.gmane.org
+dir.gmane.org
 
 

 
log4cxx-dev : log4cxx developmentSubscribe
+Subscribe
 Unsubscribe
+Unsubscribe
 Post
+Post
 mail-archives.apache.org
+mail-archives.apache.org
 markmail.org
+markmail.org
 
 

 
  
  
  marc.info
+marc.info
 
 

 
  
  
  dir.gmane.org
+dir.gmane.org
 
 

 


Modified: logging/site/trunk/docs/log4cxx/project-info.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/project-info.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/project-info.html (original)
+++ logging/site/trunk/docs/log4cxx/project-info.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
   
     
             

-        Last Published: 2008-02-23
+        Last Published: 2008-03-28
                           |   
                 Apache
                 >
@@ -217,7 +217,7 @@
     

       

         
Project Information

-
This document provides an overview of the various documents and links that are part of this project's general information. All of this content is automatically generated by Maven
+
This document provides an overview of the various documents and links that are part of this project's general information. All of this content is automatically generated by Maven
  on behalf of the project.

 
Overview

 

Modified: logging/site/trunk/docs/log4cxx/project-reports.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/project-reports.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/project-reports.html (original)
+++ logging/site/trunk/docs/log4cxx/project-reports.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
   
     
             

-        Last Published: 2008-02-23
+        Last Published: 2008-03-28
                           |   
                 Apache
                 >
@@ -217,7 +217,7 @@
     

       

         
Generated Reports

-
This document provides an overview of the various reports that are automatically generated by Maven
+
This document provides an overview of the various reports that are automatically generated by Maven
  Each report is briefly described below.

 
Overview

 
Document


Modified: logging/site/trunk/docs/log4cxx/source-repository.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/source-repository.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/source-repository.html (original)
+++ logging/site/trunk/docs/log4cxx/source-repository.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
   
     
             

-        Last Published: 2008-02-23
+        Last Published: 2008-03-28
                           |   
                 Apache
                 >
@@ -217,12 +217,12 @@
     

       

         
Overview

-This project uses Subversion
- to manage its source code. Instructions on Subversion use can be found at http://svnbook.red-bean.com/
+This project uses Subversion
+ to manage its source code. Instructions on Subversion use can be found at http://svnbook.red-bean.com/
 .

 
Web Access

 
The following is a link to the online source repository.

-
http://svn.apache.org/viewcvs.cgi/logging/log4cxx/trunk
+
http://svn.apache.org/viewcvs.cgi/logging/log4cxx/trunk
 

 

 


Modified: logging/site/trunk/docs/log4cxx/stylesheets/project.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/stylesheets/project.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/stylesheets/project.html (original)
+++ logging/site/trunk/docs/log4cxx/stylesheets/project.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
   
     
             

-        Last Published: 2008-02-23
+        Last Published: 2008-03-28
                           |   
                 Apache
                 >




Document