logging-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bode...@apache.org
Subject svn commit: r1244132 [7/14] - in /logging/log4net/site: ./ css/ images/ images/logos/ release/ release/howto/ release/manual/
Date Tue, 14 Feb 2012 17:10:56 GMT
Added: logging/log4net/site/release/features.html
URL: http://svn.apache.org/viewvc/logging/log4net/site/release/features.html?rev=1244132&view=auto
==============================================================================
--- logging/log4net/site/release/features.html (added)
+++ logging/log4net/site/release/features.html Tue Feb 14 17:10:54 2012
@@ -0,0 +1,490 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Feb 14, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>
+        Apache log4net: Features</title>
+    <style type="text/css" media="all">
+      @import url("../css/maven-base.css");
+      @import url("../css/maven-theme.css");
+      @import url("../css/site.css");
+    </style>
+    <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+      <meta name="author" content="Nicko Cadell" />
+    <meta name="Date-Revision-yyyymmdd" content="20120214" />
+    <meta http-equiv="Content-Language" content="en" />
+        <meta name="keywords" content="log4net features, log4net" />
+        </head>
+  <body class="composite">
+    <div id="banner">
+                                      <a href="../../" id="bannerLeft">
+                                                <img src="../images/ls-logo.jpg" alt="Apache Logging Services Project" />
+                </a>
+                    <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+            
+        
+                <div class="xleft">
+        <span id="publishDate">Last Published: 2012-02-14</span>
+                  &nbsp;| <span id="projectVersion">Version: 1.2.12-SNAPSHOT</span>
+                          |                           <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+        &gt;
+                          <a href="../../" title="Logging Services">Logging Services</a>
+        &gt;
+                          <a href=".././" title="log4net">log4net</a>
+        &gt;
+    
+        Apache log4net: Features
+              </div>
+            <div class="xright">        
+        
+      </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+             
+        
+                                <h5>Apache log4net</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../index.html" title="About">About</a>
+            </li>
+                  <li class="none">
+                          <a href="../download_log4net.cgi" title="Download">Download</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/release-notes.html" title="Release Notes">Release Notes</a>
+            </li>
+                  <li class="none">
+                          <a href="../license.html" title="License">License</a>
+            </li>
+          </ul>
+                       <h5>Documentation</h5>
+                  <ul>
+                  <li class="none">
+            <strong>Features</strong>
+          </li>
+                  <li class="none">
+                          <a href="../release/framework-support.html" title="Supported Frameworks">Supported Frameworks</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/example-apps.html" title="Example Apps">Example Apps</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/config-examples.html" title="Config Examples">Config Examples</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/building.html" title="Building">Building</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/faq.html" title="FAQ">FAQ</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/howto/index.html" title="How Tos">How Tos</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/sdk/index.html" title="SDK Reference">SDK Reference</a>
+            </li>
+          </ul>
+                       <h5>Manual</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../release/manual/introduction.html" title="Introduction">Introduction</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/configuration.html" title="Configuration">Configuration</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/contexts.html" title="Contexts">Contexts</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/plugins.html" title="Plugins">Plugins</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/repositories.html" title="Repositories">Repositories</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/internals.html" title="Internals">Internals</a>
+            </li>
+          </ul>
+                       <h5>Community</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+            </li>
+                  <li class="none">
+                          <a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+            </li>
+          </ul>
+                       <h5>Development</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../source-repository.html" title="Repository">Repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../integration.html" title="Continuous Integration">Continuous Integration</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                                                                                                                                                                                        <li class="collapsed">
+                          <a href="../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+                                                                    <li class="collapsed">
+                          <a href="../project-reports.html" title="Project Reports">Project Reports</a>
+                  </li>
+          </ul>
+                       <h5>Apache</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/" class="externalLink" title="Home">Home</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/licenses/" class="externalLink" title="License">License</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">Sponsorship</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/security/" class="externalLink" title="Security">Security</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apachecon.com" class="externalLink" title="Conferences">Conferences</a>
+            </li>
+          </ul>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+                   
+        
+            </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        <!-- Licensed to the Apache Software Foundation (ASF) under one or more 
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership. 
+The ASF licenses this file to you under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with 
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. -->
+
+    
+        <a name="main"></a><div class="section"><h2 id="main">Apache log4net&#x2122; Features</h2>
+        
+            <a name="overview"></a><div class="section"><h2 id="overview">Overview</h2>
+                <p>
+                    log4net is a tool to help the programmer output log statements to a 
+                    variety of output targets. In case of problems with an application, 
+                    it is helpful to enable logging so that the problem can be located. 
+                    With log4net it is possible to enable logging at runtime without 
+                    modifying the application binary. The log4net package is designed so 
+                    that log statements can remain in shipped code without incurring a 
+                    high performance cost. It follows that the speed of logging (or 
+                    rather not logging) is crucial.
+                </p>
+                <p>
+                    At the same time, log output can be so voluminous that it quickly becomes 
+                    overwhelming. One of the distinctive features of log4net is the notion of 
+                    hierarchical loggers. Using these loggers it is possible to selectively 
+                    control which log statements are output at arbitrary granularity. 
+                </p>
+                <p>
+                    log4net is designed with two distinct goals in mind: speed and flexibility
+                </p>
+            </div>
+            
+            <a name="features"></a><div class="section"><h2 id="features">Features</h2>
+                <ul>
+                    <li>Support for multiple frameworks</li>
+                    <li>Output to multiple logging targets</li>
+                    <li>Hierarchical logging architecture</li>
+                    <li>XML Configuration</li>
+                    <li>Dynamic Configuration</li>
+                    <li>Logging Context</li>
+                    <li>Proven architecture</li>
+                    <li>Modular and extensible design</li>
+                    <li>High performance with flexibility</li>
+                </ul>
+            </div>
+
+            <a name="frameworks"></a><div class="section"><h2 id="frameworks">Support for multiple frameworks</h2>
+                <p>
+                    log4net runs on all ECMA CLI 1.0 compatible runtimes.
+                    log4net has specific builds for the following frameworks:
+                </p>
+                <ul>
+                    <li>Microsoft&#xae; .NET Framework 1.0</li>
+                    <li>Microsoft .NET Framework 1.1</li>
+                    <li>Microsoft .NET Framework 2.0</li>
+                    <li>Microsoft .NET Framework 3.5</li>
+                    <li>Microsoft .NET Framework 4.0</li>
+                    <li>Microsoft .NET Framework 3.5 Client Profile</li>
+                    <li>Microsoft .NET Framework 4.0 Client Profile</li>
+                    <li>Microsoft .NET Compact Framework 1.0<a href="#no-bin-support"><sup>*</sup></a></li>
+                    <li>Microsoft .NET Compact Framework 2.0</li>
+                    <li>Mono 1.0</li>
+                    <li>Mono 2.0</li>
+                    <li>Microsoft Shared Source CLI 1.0<a href="#no-bin-support"><sup>*</sup></a></li>
+                    <li>CLI 1.0 Compatible</li>
+                </ul>
+                <p>The &quot;Client Profile&quot; builds are stripped down
+                versions of the &quot;normal&quot; builds that don't contain any
+                ASP.NET releated code - which for example means the
+                <tt>%aspnet-*</tt> patterns and the
+                <tt>AspNetTraceAppender</tt> are not available.</p>
+
+                <p style="font-size:smaller">
+                  <a name="no-bin-support"><sup>*</sup></a>Not
+                  supported by the binary release but can be built
+                  from the source release.
+                </p>
+            </div>
+
+            <a name="appenders"></a><div class="section"><h2 id="appenders">Output to multiple logging targets</h2>
+                <p>
+                    log4net ships with the following appenders (not on all frameworks):
+                </p>
+                <div class="table">
+                    <table border="0" class="bodyTable" cellspacing="0">
+                        <tr class="a">
+                            <th>
+                                Type</th>
+                            <th>
+                                Description</th>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.AdoNetAppender</td>
+                            <td>
+                                Writes logging events to a database using either prepared statements or stored 
+                                procedures.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.AnsiColorTerminalAppender</td>
+                            <td>
+                                Writes color highlighted logging events to a an ANSI terminal window.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.AspNetTraceAppender</td>
+                            <td>
+                                Writes logging events to the ASP trace context. These can then be rendered at 
+                                the end of the ASP page or on the ASP trace page.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.ColoredConsoleAppender</td>
+                            <td>
+                                Writes color highlighted logging events to the application's Windows Console.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.ConsoleAppender</td>
+                            <td>
+                                Writes logging events to the application's Console. The events may go to either 
+                                the standard our stream or the standard error stream.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.DebugAppender</td>
+                            <td>
+                                Writes logging events to the .NET  system.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.EventLogAppender</td>
+                            <td>
+                                Writes logging events to the Windows Event Log.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.FileAppender</td>
+                            <td>
+                                Writes logging events to a file in the file system.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.LocalSyslogAppender</td>
+                            <td>
+                                Writes logging events to the local syslog service (UNIX only).
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.MemoryAppender</td>
+                            <td>
+                                Stores logging events in an in memory buffer.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.NetSendAppender</td>
+                            <td>
+                                Writes logging events to the Windows Messenger service. These messages are 
+                                displayed in a dialog on a users terminal.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.OutputDebugStringAppender</td>
+                            <td>
+                                Writes logging events to the debugger. If the application has no 
+                                debugger, the system debugger displays the string. If the application has no 
+                                debugger and the system debugger is not active, the message is ignored.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.RemoteSyslogAppender</td>
+                            <td>
+                                Writes logging events to a remote syslog service using UDP networking.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.RemotingAppender</td>
+                            <td>
+                                Writes logging events to a remoting sink using .NET remoting.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.RollingFileAppender</td>
+                            <td>
+                                Writes logging events to a file in the file system. The RollingFileAppender can 
+                                be configured to log to multiple files based upon date or file size 
+                                constraints.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.SmtpAppender</td>
+                            <td>
+                                Sends logging events to an email address.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.SmtpPickupDirAppender</td>
+                            <td>
+                                Sends logging events to an email
+                                address but writes the emails to a
+                                configurable directory rather than
+                                sending them directly via SMTP.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.TelnetAppender</td>
+                            <td>
+                                Clients connect via Telnet to receive logging events.
+                            </td>
+                        </tr>
+                        <tr class="b">
+                            <td>log4net.Appender.TraceAppender</td>
+                            <td>
+                                Writes logging events to the .NET trace system.
+                            </td>
+                        </tr>
+                        <tr class="a">
+                            <td>log4net.Appender.UdpAppender</td>
+                            <td>
+                                Sends logging events as connectionless UDP datagrams to a remote host or a 
+                                multicast group using a UdpClient.
+                            </td>
+                        </tr>
+                    </table>
+                </div>
+                <p>A special log4net.Appender.ForwardingAppender can
+                be used to wrap another appender, for example to
+                attach additional filters.</p>
+            </div>
+
+            <a name="hierarchy"></a><div class="section"><h2 id="hierarchy">Hierarchical logging architecture</h2>
+                <p>
+                    Hierarchical logging is an ideal fit with component based development. 
+                    Each component has its own of logger. When individually tested, the 
+                    properties of these loggers may be set as the developer requires. 
+                    When combined with other components, the loggers inherit the properties 
+                    determined by the integrator of the components. One can selectively elevate 
+                    logging priorities on one component without affecting the other components. 
+                    This is useful when you need a detailed trace from just a single component 
+                    without crowding the trace file with messages from other components. All 
+                    this can be done through configuration files; no code changes are required.             
+                </p>
+            </div>
+
+            <a name="xml-config"></a><div class="section"><h2 id="xml-config">XML Configuration</h2>
+                <p>
+                    log4net is configured using an XML configuration file. The configuration 
+                    information can be embedded within other XML configuration files
+                    (such as the application's .config file) or in a separate file. The
+                    configuration is easily readable and updateable while retaining the
+                    flexibility to express all configurations.
+                </p>
+                <p>
+                    Alternatively log4net can be configured programmatically.
+                </p>
+            </div>
+
+            <a name="dynamic-config"></a><div class="section"><h2 id="dynamic-config">Dynamic Configuration</h2>
+                <p>
+                    log4net can monitor its configuration file for changes and dynamically
+                    apply changes made by the configurator. The logging levels, appenders, 
+                    layouts, and just about everything else can be adjusted at runtime. 
+                    In many cases it is possible to diagnose application issues without 
+                    terminating the process in question. This can a very valuable tool in
+                    investigating issues with deployed applications.
+                </p>
+            </div>
+
+            <a name="context"></a><div class="section"><h2 id="context">Logging Context</h2>
+                <p>
+                    log4net can be used to collect logging context data in a way that is transparent 
+                    to the developer at the point of logging. The GlobalContext and the 
+                    ThreadContext allow the application to store contextual data that is
+                    attached to logging messages. For instance, in a web service, 
+                    once the caller is authenticated the username of the caller could be 
+                    stored in a ThreadContext property. This property would then be automatically 
+                    logged as part of each subsequent logging message made from the same thread.
+                </p>
+            </div>
+
+            <a name="history"></a><div class="section"><h2 id="history">Proven architecture</h2>
+                <p>
+                    log4net is based on the highly successful Apache log4j&#x2122; logging library,
+                    in development since 1996. This popular and proven architecture has 
+                    so far been ported to 12 languages.
+                </p>
+            </div>
+            
+        </div>
+    
+
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">
+        <div class="xright">Copyright &#169;                    2004-2012
+                        <a href="http://www.apache.org">Apache Software Foundation</a>.
+                  
+        
+       Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>.</div><br />
+        <div class="xright">Apache log4net, Apache, log4net, the Apache feather logo, the Apache Logging Services project logo and the Built by Maven logo are trademarks of The Apache Software Foundation.</div>
+        <div class="clear">
+      </div>
+    </div>
+  </body>
+</html>

Propchange: logging/log4net/site/release/features.html
------------------------------------------------------------------------------
    svn:executable = *

Added: logging/log4net/site/release/framework-support.html
URL: http://svn.apache.org/viewvc/logging/log4net/site/release/framework-support.html?rev=1244132&view=auto
==============================================================================
--- logging/log4net/site/release/framework-support.html (added)
+++ logging/log4net/site/release/framework-support.html Tue Feb 14 17:10:54 2012
@@ -0,0 +1,928 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Feb 14, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>
+        Apache log4net: Supported Frameworks</title>
+    <style type="text/css" media="all">
+      @import url("../css/maven-base.css");
+      @import url("../css/maven-theme.css");
+      @import url("../css/site.css");
+    </style>
+    <link rel="stylesheet" href="../css/print.css" type="text/css" media="print" />
+      <meta name="author" content="Nicko Cadell" />
+    <meta name="Date-Revision-yyyymmdd" content="20120214" />
+    <meta http-equiv="Content-Language" content="en" />
+        <meta name="keywords" content="log4net supported frameworks, mono, sscli, .net, log4net" />
+        </head>
+  <body class="composite">
+    <div id="banner">
+                                      <a href="../../" id="bannerLeft">
+                                                <img src="../images/ls-logo.jpg" alt="Apache Logging Services Project" />
+                </a>
+                    <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+            
+        
+                <div class="xleft">
+        <span id="publishDate">Last Published: 2012-02-14</span>
+                  &nbsp;| <span id="projectVersion">Version: 1.2.12-SNAPSHOT</span>
+                          |                           <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+        &gt;
+                          <a href="../../" title="Logging Services">Logging Services</a>
+        &gt;
+                          <a href=".././" title="log4net">log4net</a>
+        &gt;
+    
+        Apache log4net: Supported Frameworks
+              </div>
+            <div class="xright">        
+        
+      </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+             
+        
+                                <h5>Apache log4net</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../index.html" title="About">About</a>
+            </li>
+                  <li class="none">
+                          <a href="../download_log4net.cgi" title="Download">Download</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/release-notes.html" title="Release Notes">Release Notes</a>
+            </li>
+                  <li class="none">
+                          <a href="../license.html" title="License">License</a>
+            </li>
+          </ul>
+                       <h5>Documentation</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../release/features.html" title="Features">Features</a>
+            </li>
+                  <li class="none">
+            <strong>Supported Frameworks</strong>
+          </li>
+                  <li class="none">
+                          <a href="../release/example-apps.html" title="Example Apps">Example Apps</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/config-examples.html" title="Config Examples">Config Examples</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/building.html" title="Building">Building</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/faq.html" title="FAQ">FAQ</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/howto/index.html" title="How Tos">How Tos</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/sdk/index.html" title="SDK Reference">SDK Reference</a>
+            </li>
+          </ul>
+                       <h5>Manual</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../release/manual/introduction.html" title="Introduction">Introduction</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/configuration.html" title="Configuration">Configuration</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/contexts.html" title="Contexts">Contexts</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/plugins.html" title="Plugins">Plugins</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/repositories.html" title="Repositories">Repositories</a>
+            </li>
+                  <li class="none">
+                          <a href="../release/manual/internals.html" title="Internals">Internals</a>
+            </li>
+          </ul>
+                       <h5>Community</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+            </li>
+                  <li class="none">
+                          <a href="../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+            </li>
+          </ul>
+                       <h5>Development</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../source-repository.html" title="Repository">Repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../integration.html" title="Continuous Integration">Continuous Integration</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                                                                                                                                                                                        <li class="collapsed">
+                          <a href="../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+                                                                    <li class="collapsed">
+                          <a href="../project-reports.html" title="Project Reports">Project Reports</a>
+                  </li>
+          </ul>
+                       <h5>Apache</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/" class="externalLink" title="Home">Home</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/licenses/" class="externalLink" title="License">License</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">Sponsorship</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/security/" class="externalLink" title="Security">Security</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apachecon.com" class="externalLink" title="Conferences">Conferences</a>
+            </li>
+          </ul>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
+      </a>
+                   
+        
+            </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        <!-- Licensed to the Apache Software Foundation (ASF) under one or more 
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership. 
+The ASF licenses this file to you under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with 
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. -->
+
+    
+        <a name="main"></a><div class="section"><h2 id="main">Apache log4net&#x2122; Supported Frameworks</h2>
+        
+            <a name="summary"></a><div class="section"><h2 id="summary">Summary of .NET frameworks supported by log4net</h2>
+                <p>
+                    log4net is built on a number of different frameworks. Each new version of the frameworks add
+                    new features. To take advantage of these new features we must build log4net using the
+                    appropriate framework. We also maintain builds compatible with older versions of the frameworks.
+                </p>
+                <p>
+                    It is important to remember that the .NET frameworks support backward compatibility, that is
+                    a new version of the framework will run binary assemblies that were targeted to previous versions
+                    of the framework.
+                </p>
+                <p>
+                    While the number of different builds available may seem confusing, you only need to select the
+                    nearest build for your platform that is equal to or earlier than your chosen deployment framework.
+                    If you intend to deploy your application on the Microsoft&#xae; .NET Framework 1.0 don't pick the
+                    log4net build that is built against the Microsoft .NET Framework 1.1 because the .NET framework
+                    does not guarantee forward compatibility only backward compatibility.
+                </p>
+                <p>
+                    The lowest common denominator build is the CLI 1.0 Compatible build. This build is compatible with
+                    the ECMA/ISO CLI 1.0 standard APIs and will run on all frameworks that support the standard. (Note
+                    that the Microsoft .NET Compact Framework does not support this standard). Use this build if you
+                    intend to deploy you application on both the Microsoft .NET Frameworks and the Mono frameworks.
+                </p>
+                <p>
+                    log4net now builds on the following frameworks:
+                </p>
+                
+                <div class="table">
+                    <table border="0" class="bodyTable">
+                        <colgroup>
+                            <col style="text-align: left; white-space: nowrap" />
+                            <col style="text-align: left;" />
+                        </colgroup>
+                        <tr class="a">
+                            <th>Framework</th>
+                            <th>Website</th>
+                        </tr>
+                        <tr class="b" style="vertical-align: top;">
+                            <td>Microsoft .NET Framework 1.0</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+                        </tr>
+                        <tr class="a" style="vertical-align: top;">
+                            <td>Microsoft .NET Framework 1.1</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+                        </tr>
+                        <tr class="b" style="vertical-align: top;">
+                            <td>Microsoft .NET Framework 2.0</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+                        </tr>
+                        <tr class="a" style="vertical-align: top;">
+                            <td>Microsoft .NET Framework 3.5</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+                        </tr>
+                        <tr class="b" style="vertical-align: top;">
+                            <td>Microsoft .NET Framework 4.0</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/">http://msdn.microsoft.com/en-us/netframework/</a></td>
+                        </tr>
+                        <tr class="a" style="vertical-align: top;">
+                            <td>Microsoft .NET Framework 3.5 Client Profile</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/library/cc656912.aspx">http://msdn.microsoft.com/en-us/library/cc656912.aspx</a></td>
+                        </tr>
+                        <tr class="b" style="vertical-align: top;">
+                            <td>Microsoft .NET Framework 4.0 Client Profile</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/library/cc656912.aspx">http://msdn.microsoft.com/en-us/library/cc656912.aspx</a></td>
+                        </tr>
+                        <tr class="a" style="vertical-align: top;">
+                            <td>Microsoft .NET Compact Framework 1.0</td>
+                            <td><a class="externalLink" href="http://msdn2.microsoft.com/en-us/netframework/aa497273.aspx">http://msdn2.microsoft.com/en-us/netframework/aa497273.aspx</a></td>
+                        </tr>
+                        <tr class="b" style="vertical-align: top;">
+                            <td>Microsoft .NET Compact Framework 2.0</td>
+                            <td><a class="externalLink" href="http://msdn2.microsoft.com/en-us/netframework/aa497273.aspx">http://msdn2.microsoft.com/en-us/netframework/aa497273.aspx</a></td>
+                        </tr>
+                        <tr class="a" style="vertical-align: top;">
+                            <td>Mono</td>
+                            <td><a class="externalLink" href="http://www.mono-project.com">http://www.mono-project.com</a></td>
+                        </tr>
+                        <tr class="b" style="vertical-align: top;">
+                            <td>Microsoft Shared Source CLI 1.0</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/library/ms973879.aspx">http://msdn.microsoft.com/en-us/library/ms973879.aspx</a></td>
+                        </tr>
+                        <tr class="a" style="vertical-align: top;">
+                            <td>CLI 1.0 Compatible</td>
+                            <td><a class="externalLink" href="http://msdn.microsoft.com/en-us/netframework/aa569283.aspx">http://msdn.microsoft.com/en-us/netframework/aa569283.aspx</a></td>
+                        </tr>
+                    </table>
+                </div>
+                <p>
+                    For most of these frameworks a log4net assembly targeting the framework is supplied.  Although it's 
+                    perfectly possible to use the .NET Framework 1.0 version of log4net on the .NET Framework 1.1, having 
+                    an assembly that really targets a specific framework allows us to use features in that framework that 
+                    are not available in other frameworks or remove features from log4net that are not supported in a 
+                    specific framework.
+                </p>
+                <p>
+                  There are no assemblies targeting the Compact
+                  Framework 1.0 or Microsoft Shared Source CLI 1.0 in
+                  the binary release, but they can be built from the
+                  source release.
+                </p>
+            </div>
+            
+            <a name="appenders"></a><div class="section"><h2 id="appenders">Appenders</h2>
+                <p>
+                    The appenders available to each framework depend on the functionality of the 
+                    framework and the platform it runs on:
+                </p>
+                <div class="table">
+                    <table border="0" class="bodyTable">
+                        <colgroup>
+                            <col style="text-align: left;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                            <col style="text-align: center;" />
+                        </colgroup>
+                        <tr class="a">
+                            <th>Appender</th>
+                            <th>.NET Framework 1.0</th>
+                            <th>.NET Framework 1.1</th>
+                            <th>.NET Framework 2.0</th>
+                            <th>.NET Framework 3.5</th>
+                            <th>.NET Framework 4.0</th>
+                            <th>.NET Framework 3.5 Client Profile</th>
+                            <th>.NET Framework 4.0 Client Profile</th>
+                            <th>.NET CF 1.0</th>
+                            <th>.NET CF 2.0</th>
+                            <th>Mono</th>
+                            <th>Shared Source CLI 1.0</th>
+                            <th>CLI 1.0 Compatible</th>
+                        </tr>
+                        <tr class="b">
+                            <td>AdoNetAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>AnsiColorTerminalAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>AspNetTraceAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>BufferingForwardingAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>ColoredConsoleAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                        </tr>
+                        <tr class="a">
+                            <td>ConsoleAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>DebugAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>EventLogAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>FileAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>ForwardingAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>LocalSyslogAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>ManagedColoredConsoleAppender</td>
+                            <td></td>
+                            <td></td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                        </tr>
+                        <tr class="b">
+                            <td>MemoryAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>NetSendAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                        </tr>
+                        <tr class="b">
+                            <td>OutputDebugStringAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                        </tr>
+                        <tr class="a">
+                            <td>RemoteSyslogAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>RemotingAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>RollingFileAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>SmtpAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>SmtpPickupDirAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>TelnetAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>TraceAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>UdpAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                    </table>
+                </div>
+            </div>
+            
+            <a name="notes"></a><div class="section"><h2 id="notes">Framework Specific Notes</h2>
+                <a name="net1.0"></a><div class="section"><h2 id="net1.0">Microsoft .NET Framework 1.0</h2>
+                    <p>
+                        none
+                    </p>
+                </div>
+                
+                <a name="net1.1"></a><div class="section"><h2 id="net1.1">Microsoft .NET Framework 1.1</h2>
+                    <p>
+                        none
+                    </p>
+                </div>
+                
+                <a name="net2.0"></a><div class="section"><h2 id="net2.0">Microsoft .NET Framework 2.0</h2>
+                    <p>
+                        none
+                    </p>
+                </div>
+                
+                <a name="net3.5"></a><div class="section"><h2 id="net3.5">Microsoft .NET Framework 3.5</h2>
+                    <p>
+                        As of log4net 1.2.11 this version is identical
+                        to the .NET 2.0 version.
+                    </p>
+                </div>
+                
+                <a name="net4.0"></a><div class="section"><h2 id="net4.0">Microsoft .NET Framework 4.0</h2>
+                    <p>
+                        none
+                    </p>
+                </div>
+                
+                <a name="netcp3.5"></a><div class="section"><h2 id="netcp3.5">Microsoft .NET Framework 3.5 Client Profile</h2>
+                    <p>
+                        As of log4net 1.2.11 this version is identical
+                        to the .NET 3.5 version without support for
+                        ASP.NET specific appenders and patterns.
+                    </p>
+                </div>
+                
+                <a name="netcp4.0"></a><div class="section"><h2 id="netcp4.0">Microsoft .NET Framework 4.0 Client Profile</h2>
+                    <p>
+                        As of log4net 1.2.11 this version is identical
+                        to the .NET 4.0 version without support for
+                        ASP.NET specific appenders and patterns.
+                    </p>
+                </div>
+                
+                <a name="netcf1.0"></a><div class="section"><h2 id="netcf1.0">Microsoft .NET Compact Framework 1.0</h2>
+                            <div class="section"><div class="section"><h4>Assembly attributes<a name="Assembly_attributes"></a></h4>
+                            <p>
+                                The .NET Compact Framework 1.0 does not support retrieving assembly level 
+                                attributes, therefore all log4net configuration attributes were removed from 
+                                the .NET Compact Framework 1.0 version of log4net.
+                            </p>
+                            <p>
+                                For Smart-device applications, the log4net system can be configured by passing 
+                                the location of the log4net configuration file to the
+                                <span class="code">log4net.Config.XmlConfigurator.Configure(FileInfo)</span>
+                                method in the entry point of the application.
+                            </p>
+                            <p>For example:</p>
+                            <p></p>
+                            <div class="code"><pre>
+namespace TestApp
+{
+    using System.IO;
+
+    public class EntryPoint
+    {
+        /// &lt;summary&gt;
+        /// Application entry point.
+        /// &lt;/summary&gt;
+        public static void Main() 
+        {
+            // Uncomment the next line to enable log4net internal debugging
+            // log4net.Util.LogLog.InternalDebugging = true;
+
+            // This will instruct log4net to look for a configuration file
+            // called config.log4net in the root directory of the device
+            log4net.Config.XmlConfigurator.Configure(new FileInfo(@&quot;\config.log4net&quot;));
+
+            ...
+            
+            // This will shutdown the log4net system
+            log4net.LogManager.Shutdown();
+        }
+    }
+}                        
+                            </pre></div>
+                            </div><div class="section"><h4>Notification events<a name="Notification_events"></a></h4>
+                            <p>
+                                The .NET Compact Framework 1.0 does not support notification events during the 
+                                application shutdown, therefore log4net cannot automatically hook the 
+                                application shutdown notification.
+                            </p>
+                            <p>
+                                Applications will need to programmatically shutdown the log4net system during 
+                                the application's shutdown using the
+                                <span class="code">log4net.LogManager.Shutdown()</span>
+                                method in order to prevent losing logging events.
+                                See the code above for an example.
+                            </p>
+                            </div><div class="section"><h4>FileSystemWatcher<a name="FileSystemWatcher"></a></h4>
+                            <p>
+                                The .NET Compact Framework 1.0 does not support the
+                                <span class="code">System.IO.FileSystemWatcher</span>
+                                class. As a result, the
+                                <span class="code">XmlConfiguratorAttribute.Watch</span>
+                                property and the 
+                                <span class="code">XmlConfigurator.ConfigureAndWatch</span>
+                                methods are not available. Watching changes to the log4net configuration 
+                                file is not supported on the .NET Compact Framework 1.0.
+                            </p>
+                            </div><div class="section"><h4>UserName<a name="UserName"></a></h4>
+                            <p>
+                                The .NET Compact Framework 1.0 does not support the
+                                <span class="code">System.Security.Principal.WindowsIdentity</span> class.
+                                This is used to capture the current thread's user identity. Therefore
+                                the <span class="code">LoggingEvent.UserName</span> property will return the value 
+                                <span class="code">&quot;NOT AVAILABLE&quot;</span>.
+                            </p>
+                            </div><div class="section"><h4>Identity<a name="Identity"></a></h4>
+                            <p>
+                                The .NET Compact Framework 1.0 does not support the
+                                <span class="code">System.Security.Principal.IPrincipal</span> interface.
+                                This is used to capture the current thread's user identity. Therefore
+                                the <span class="code">LoggingEvent.Identity</span> property will return the value 
+                                <span class="code">&quot;NOT AVAILABLE&quot;</span>.
+                            </p>
+                            </div><div class="section"><h4>Environment variables<a name="Environment_variables"></a></h4>
+                            <p>
+                                The .NET Compact Framework 1.0 does not support retrieving environment 
+                                variables, therefore it's not possible to substitute environment variables in 
+                                parameter values when using the .NET Compact Framework 1.0 version of log4net.
+                            </p>
+                            </div><div class="section"><h4>Serialization<a name="Serialization"></a></h4>
+                            <p>
+                                The .NET Compact Framework 1.0 does not support serialization, therefore none of 
+                                the log4net classes in the .NET Compact Framework 1.0 version are serializable.
+                            </p>
+                            </div><div class="section"><h4>LoggingEvent.Domain<a name="LoggingEvent.Domain"></a></h4>
+                            <p>
+                                The .NET Compact Framework 1.0 does not support AppDomain functionality. The
+                                friendly name for the current AppDomain is stored in the <span class="code">LoggingEvent.Domain</span>
+                                property and is accessed using the <span class="code">%a</span> pattern of the 
+                                <span class="code">PatternLayout</span>. On the .NET Compact Framework 1.0 this
+                                value is generated by taking the file name for the application's primary module.
+                            </p>
+                </div></div></div>
+                <a name="netcf2.0"></a><div class="section"><h2 id="netcf2.0">Microsoft .NET Compact Framework 2.0</h2>
+                    <p>
+                        See notes for .NET Compact Framework 1.0
+                    </p>
+                </div>
+                <a name="mono"></a><div class="section"><h2 id="mono">Mono</h2>
+                    <p>
+                        There are 2 separate builds of log4net for mono; Mono 1.0, built using the C# compiler in a mode 
+                        which is compatible with the CLI 1.0 language specification, and; Mono 2.0, built using the .NET 
+                        2.0 extensions to the C# language.
+                    </p>
+                
+                    <a name="mono1.0"></a><div class="section"><h2 id="mono1.0">Mono 1.0</h2>
+                        <p>
+                            none
+                        </p>
+                    </div>
+                    <a name="mono2.0"></a><div class="section"><h2 id="mono2.0">Mono 2.0</h2>
+                        <p>
+                            none
+                        </p>
+                    </div>
+                    
+                </div>
+                
+                <a name="sscli1.0"></a><div class="section"><h2 id="sscli1.0">Microsoft Shared Source CLI 1.0</h2>
+                            <div class="section"><div class="section"><h4>FileSystemWatcher<a name="FileSystemWatcher"></a></h4>
+                            <p>
+                                SSCLI 1.0 does not support the
+                                <span class="code">System.IO.FileSystemWatcher</span>
+                                class. As a result, the
+                                <span class="code">XmlConfiguratorAttribute.Watch</span>
+                                property and the 
+                                <span class="code">XmlConfigurator.ConfigureAndWatch</span>
+                                methods are not available. Watching changes to the log4net configuration 
+                                file is not supported on SSCLI 1.0.
+                            </p>
+                            </div><div class="section"><h4>UserName<a name="UserName"></a></h4>
+                            <p>
+                                SSCLI 1.0 does not support the
+                                <span class="code">System.Security.Principal.WindowsIdentity</span> class.
+                                This is used to capture the current thread's user identity. Therefore
+                                the <span class="code">LoggingEvent.UserName</span> property will return the value 
+                                <span class="code">&quot;NOT AVAILABLE&quot;</span>.
+                            </p>
+                            </div><div class="section"><h4>Identity<a name="Identity"></a></h4>
+                            <p>
+                                SSCLI 1.0 does not support the
+                                <span class="code">System.Security.Principal.IPrincipal</span> interface.
+                                This is used to capture the current thread's user identity. Therefore
+                                the <span class="code">LoggingEvent.Identity</span> property will return the value 
+                                <span class="code">&quot;NOT AVAILABLE&quot;</span>.
+                            </p>
+                </div></div></div>
+                
+                <a name="cli1.0"></a><div class="section"><h2 id="cli1.0">CLI 1.0 Compatible</h2>
+                    <p>
+                        This build of log4net is designed to run on any ECMA CLI 1.0 compatible runtime.
+                        The assembly does not support any platform specific features. The build includes
+                        the common subset of functionality found in the .NET 1.0 and Mono 1.0 builds.
+                        The output assembly is built using the Microsoft .NET 1.0 compiler and library.
+                    </p>
+                    <p>
+                        The log4net CLI 1.0 assembly is runtime compatible with the following frameworks:
+                    </p>
+                    <ul>
+                        <li>Microsoft .NET Framework 1.0 (and higher)</li>
+                        <li>Mono 1.0 (and higher)</li>
+                    </ul>
+                    <p>
+                        Only a Release build is generated for this configuration because the assembly
+                        debugging information has not been standardized.
+                    </p>
+                </div>
+                
+            </div>
+            
+        </div>
+        
+    
+
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">
+        <div class="xright">Copyright &#169;                    2004-2012
+                        <a href="http://www.apache.org">Apache Software Foundation</a>.
+                  
+        
+       Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>.</div><br />
+        <div class="xright">Apache log4net, Apache, log4net, the Apache feather logo, the Apache Logging Services project logo and the Built by Maven logo are trademarks of The Apache Software Foundation.</div>
+        <div class="clear">
+      </div>
+    </div>
+  </body>
+</html>

Propchange: logging/log4net/site/release/framework-support.html
------------------------------------------------------------------------------
    svn:executable = *

Added: logging/log4net/site/release/howto/chainsaw.html
URL: http://svn.apache.org/viewvc/logging/log4net/site/release/howto/chainsaw.html?rev=1244132&view=auto
==============================================================================
--- logging/log4net/site/release/howto/chainsaw.html (added)
+++ logging/log4net/site/release/howto/chainsaw.html Tue Feb 14 17:10:54 2012
@@ -0,0 +1,290 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at Feb 14, 2012 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>
+        Apache log4net: How To view logging events using Apache log4j Chainsaw</title>
+    <style type="text/css" media="all">
+      @import url("../../css/maven-base.css");
+      @import url("../../css/maven-theme.css");
+      @import url("../../css/site.css");
+    </style>
+    <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
+      <meta name="author" content="Ron Grabowski" />
+      <meta name="author" content="Nicko Cadell" />
+    <meta name="Date-Revision-yyyymmdd" content="20120214" />
+    <meta http-equiv="Content-Language" content="en" />
+        <meta name="keywords" content="chainsaw log4net, log4net" />
+        </head>
+  <body class="composite">
+    <div id="banner">
+                                      <a href="../../../" id="bannerLeft">
+                                                <img src="../../images/ls-logo.jpg" alt="Apache Logging Services Project" />
+                </a>
+                    <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+            
+        
+                <div class="xleft">
+        <span id="publishDate">Last Published: 2012-02-14</span>
+                  &nbsp;| <span id="projectVersion">Version: 1.2.12-SNAPSHOT</span>
+                          |                           <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+        &gt;
+                          <a href="../../../" title="Logging Services">Logging Services</a>
+        &gt;
+                          <a href="../.././" title="log4net">log4net</a>
+        &gt;
+    
+        Apache log4net: How To view logging events using Apache log4j Chainsaw
+              </div>
+            <div class="xright">        
+        
+      </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+             
+        
+                                <h5>Apache log4net</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../../index.html" title="About">About</a>
+            </li>
+                  <li class="none">
+                          <a href="../../download_log4net.cgi" title="Download">Download</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/release-notes.html" title="Release Notes">Release Notes</a>
+            </li>
+                  <li class="none">
+                          <a href="../../license.html" title="License">License</a>
+            </li>
+          </ul>
+                       <h5>Documentation</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../../release/features.html" title="Features">Features</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/framework-support.html" title="Supported Frameworks">Supported Frameworks</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/example-apps.html" title="Example Apps">Example Apps</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/config-examples.html" title="Config Examples">Config Examples</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/building.html" title="Building">Building</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/faq.html" title="FAQ">FAQ</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/howto/index.html" title="How Tos">How Tos</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/sdk/index.html" title="SDK Reference">SDK Reference</a>
+            </li>
+          </ul>
+                       <h5>Manual</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../../release/manual/introduction.html" title="Introduction">Introduction</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/manual/configuration.html" title="Configuration">Configuration</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/manual/contexts.html" title="Contexts">Contexts</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/manual/plugins.html" title="Plugins">Plugins</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/manual/repositories.html" title="Repositories">Repositories</a>
+            </li>
+                  <li class="none">
+                          <a href="../../release/manual/internals.html" title="Internals">Internals</a>
+            </li>
+          </ul>
+                       <h5>Community</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../../mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+            </li>
+                  <li class="none">
+                          <a href="../../issue-tracking.html" title="Issue Tracking">Issue Tracking</a>
+            </li>
+          </ul>
+                       <h5>Development</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="../../source-repository.html" title="Repository">Repository</a>
+            </li>
+                  <li class="none">
+                          <a href="../../integration.html" title="Continuous Integration">Continuous Integration</a>
+            </li>
+          </ul>
+                       <h5>Project Documentation</h5>
+                  <ul>
+                                                                                                                                                                                                                                                        <li class="collapsed">
+                          <a href="../../project-info.html" title="Project Information">Project Information</a>
+                  </li>
+                                                                    <li class="collapsed">
+                          <a href="../../project-reports.html" title="Project Reports">Project Reports</a>
+                  </li>
+          </ul>
+                       <h5>Apache</h5>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org/" class="externalLink" title="Home">Home</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/licenses/" class="externalLink" title="License">License</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">Sponsorship</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/security/" class="externalLink" title="Security">Security</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apachecon.com" class="externalLink" title="Conferences">Conferences</a>
+            </li>
+          </ul>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="poweredBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" />
+      </a>
+                   
+        
+            </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        <!-- Licensed to the Apache Software Foundation (ASF) under one or more 
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership. 
+The ASF licenses this file to you under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with 
+the License. You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. -->
+
+    
+        <a name="main"></a><div class="section"><h2 id="main">How To view logging events using Apache log4j Chainsaw</h2>
+            <p>
+                Apache log4j&#x2122; includes <a class="externalLink" href="http://logging.apache.org/log4j/docs/chainsaw.html">Apache Chainsaw&#x2122;</a>
+                a graphical log viewer. 
+            </p>
+            <p>
+                Chainsaw can either receive and display log events in realtime over 
+                the network, or it can load a previously created log file.
+            </p>
+            
+            <p>
+                Before Chainsaw can display data, one or more receivers must be setup. 
+                This is usually done by specifying an xml config file when the program 
+                first starts up. <br />
+                Save one or more of the sample xml config files to your local system and 
+                load them when Chainsaw starts.
+            </p>
+            
+            <a name="udp"></a><div class="section"><h2 id="udp">Logging via UDP</h2>
+                <p>
+                    Apache log4net&#x2122; can be configured to log messages via UDP in such a way that Chainsaw
+                    can receive and display them.
+                </p>
+            
+                <a name="udp-conf"></a><div class="section"><h2 id="udp-conf">log4net UDP Configuration</h2>
+                    <p>
+                        Configure log4net to use a UdpAppender with the following config snippet:
+                    </p>
+
+                    <div class="source"><pre>
+&lt;appender name=&quot;UdpAppender&quot; type=&quot;log4net.Appender.UdpAppender&quot;&gt;
+    &lt;remoteAddress value=&quot;127.0.0.1&quot; /&gt;
+    &lt;remotePort value=&quot;8080&quot; /&gt;
+    &lt;layout type=&quot;log4net.Layout.XmlLayoutSchemaLog4j&quot;&gt;
+        &lt;locationInfo value=&quot;true&quot; /&gt;
+    &lt;/layout&gt;
+&lt;/appender&gt;</pre></div>
+                </div>
+                
+                <a name="udp-chainsaw"></a><div class="section"><h2 id="udp-chainsaw">Chainsaw UDP receiver Configuration</h2>
+                    <p>
+                        Chainsaw should be configured to start a UDPReceiver using the 
+                        following configuration document:
+                    </p>
+
+                    <div class="source"><pre>
+&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot; ?&gt;
+&lt;!DOCTYPE log4j:configuration SYSTEM &quot;log4j.dtd&quot;&gt; 
+&lt;log4j:configuration xmlns:log4j=&quot;http://jakarta.apache.org/log4j/&quot; debug=&quot;true&quot;&gt;    
+    &lt;plugin name=&quot;UDPReceiver&quot; class=&quot;org.apache.log4j.net.UDPReceiver&quot;&gt;
+        &lt;param name=&quot;Port&quot; value=&quot;8080&quot; /&gt;
+    &lt;/plugin&gt;    
+&lt;/log4j:configuration&gt;</pre></div>
+                </div>
+                
+            </div>
+            
+            <a name="xml-file"></a><div class="section"><h2 id="xml-file">Logging to XML file</h2>
+                <p>
+                    Chainsaw can also load an XML log file if it is formatted according
+                    to the log4j schema. Use the following log4net config to output
+                    to file using the log4j schema:
+                </p>
+                
+                <div class="source"><pre>
+&lt;appender name=&quot;FileAppender&quot; type=&quot;log4net.Appender.FileAppender&quot;&gt;
+    &lt;file value=&quot;log-file.txt&quot; /&gt;
+    &lt;appendToFile value=&quot;true&quot; /&gt;
+    &lt;layout type=&quot;log4net.Layout.XmlLayoutSchemaLog4j&quot;&gt;
+        &lt;locationInfo value=&quot;true&quot; /&gt;
+    &lt;/layout&gt;
+&lt;/appender&gt;</pre></div>
+                
+                <p>
+                    To load the file into Chainsaw drag the file into the Chainsaw
+                    app and drop it on the tab labeled <i>Drag &amp; Drop log files here</i>.
+                </p>        
+            </div>
+            
+        </div>
+    
+
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">
+        <div class="xright">Copyright &#169;                    2004-2012
+                        <a href="http://www.apache.org">Apache Software Foundation</a>.
+                  
+        
+       Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>.</div><br />
+        <div class="xright">Apache log4net, Apache, log4net, the Apache feather logo, the Apache Logging Services project logo and the Built by Maven logo are trademarks of The Apache Software Foundation.</div>
+        <div class="clear">
+      </div>
+    </div>
+  </body>
+</html>

Propchange: logging/log4net/site/release/howto/chainsaw.html
------------------------------------------------------------------------------
    svn:executable = *



Mime
View raw message