logging-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From carn...@apache.org
Subject svn commit: r559716 [6/20] - in /logging/site/trunk/docs/log4net: ./ css/ images/ images/logos/ release/ release/howto/ release/manual/ src/ src/release/ src/release/howto/ src/release/manual/ src/stylesheets/ stylesheets/
Date Thu, 26 Jul 2007 06:41:52 GMT
Added: logging/site/trunk/docs/log4net/release/framework-support.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4net/release/framework-support.html?view=auto&rev=559716
==============================================================================
--- logging/site/trunk/docs/log4net/release/framework-support.html (added)
+++ logging/site/trunk/docs/log4net/release/framework-support.html Wed Jul 25 23:41:40 2007
@@ -0,0 +1,755 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+  <head>
+    <title>Apache log4net - 
+        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 http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+      </head>
+  <body class="composite">
+    <div id="banner">
+                  <a href="http://logging.apache.org/" id="bannerLeft">
+    
+                                            <img src="../images/ls-logo.jpg" alt="" />
+    
+            </a>
+                    <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+          
+  
+
+  
+    
+  
+  
+            <div class="xleft">
+        Last Published: 07/26/2007
+                          |   
+          <a href="http://www.apache.org/">Apache</a>
+              &gt;
+      
+          <a href="http://logging.apache.org/">Logging Services</a>
+              &gt;
+      
+          <a href="../">log4net</a>
+                        </div>
+            <div class="xright">      
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+           
+  
+
+  
+    
+  
+  
+                   <h5>Get log4net</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../download.html">Download</a>
+        </li>
+              
+    <li class="none">
+              <a href="../changes-report.html">Changes</a>
+        </li>
+              
+    <li class="none">
+              <a href="../license.html">License</a>
+        </li>
+          </ul>
+          <h5>About log4net</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../index.html">What is log4net?</a>
+        </li>
+              
+    <li class="none">
+              <a href="../faq.html">FAQ</a>
+        </li>
+              
+    <li class="none">
+              <a href="../roadmap.html">Roadmap</a>
+        </li>
+          </ul>
+          <h5>Community</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../mail-lists.html">Mailing Lists</a>
+        </li>
+              
+    <li class="none">
+              <a href="../issue-tracking.html">Issue Tracking</a>
+        </li>
+          </ul>
+          <h5>Development</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../source-repository.html">Repository</a>
+        </li>
+              
+    <li class="none">
+              <a href="../integration.html">Continuous Integration</a>
+        </li>
+          </ul>
+          <h5>Documentation</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../release/manual/introduction.html">Introduction</a>
+        </li>
+          </ul>
+          <h5>Apache</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="http://www.apache.org">Home</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apachecon.com">Conferences</a>
+        </li>
+          </ul>
+                                       <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+            <img alt="Built by Maven" src="../images/logos/maven-feather.png"></img>
+          </a>
+                       
+  
+
+  
+    
+  
+  
+        </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        
+
+    
+
+    <meta name="keywords" content="log4net supported frameworks, mono, sscli, .net, log4net"></meta>
+
+    
+        <a name="log4net Supported Frameworks"></a><div class="section"><h2>log4net Supported Frameworks</h2>
+        
+            <sectionMenu name="Contents"></sectionMenu>
+            
+            <a name="Summary of .NET frameworks supported by log4net"></a><div class="section"><h2>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 .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 6 frameworks:
+                </p>
+                
+                <div class="table">
+                    <table class="bodyTable">
+                        <colgroup>
+                            <col style="text-align: left; white-space: nowrap"></col>
+                            <col style="text-align: left;"></col>
+                        </colgroup>
+                        <tr class="a">
+                            <th>Framework</th>
+                            <th>Website</th>
+                        </tr>
+                        <tr class="b">
+                            <td>Microsoft .NET Framework 1.0 (1.0.3705)</td>
+                            <td><a href="http://msdn.microsoft.com/net">http://msdn.microsoft.com/net</a></td>
+                        </tr>
+                        <tr class="a">
+                            <td>Microsoft .NET Framework 1.1 (1.1.4322)</td>
+                            <td><a href="http://msdn.microsoft.com/net">http://msdn.microsoft.com/net</a></td>
+                        </tr>
+                        <tr class="b">
+                            <td>Microsoft .NET Framework 2.0 (2.0.50727)</td>
+                            <td><a href="http://msdn.microsoft.com/net">http://msdn.microsoft.com/net</a></td>
+                        </tr>
+                        <tr class="a">
+                            <td>Microsoft .NET Compact Framework 1.0</td>
+                            <td><a 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">
+                            <td>Mono 1.2.3</td>
+                            <td><a href="http://www.mono-project.com">http://www.mono-project.com</a></td>
+                        </tr>
+                        <tr class="a">
+                            <td>Microsoft Shared Source CLI 1.0</td>
+                            <td><a href="http://msdn.microsoft.com/library/en-us/dndotnet/html/mssharsourcecli.asp">http://msdn.microsoft.com/library/en-us/dndotnet/html/mssharsourcecli.asp</a></td>
+                        </tr>
+                        <tr class="b">
+                            <td>CLI 1.0 Compatible</td>
+                            <td><a href="http://msdn.microsoft.com/net/ecma/">http://msdn.microsoft.com/net/ecma/</a></td>
+                        </tr>
+                    </table>
+                </div>
+                <p>
+                    For each 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>
+            </div>
+            
+            <a name="Appenders"></a><div class="section"><h2>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 class="bodyTable">
+                        <colgroup>
+                            <col style="text-align: left;"></col>
+                            <col style="text-align: center;"></col>
+                            <col style="text-align: center;"></col>
+                            <col style="text-align: center;"></col>
+                            <col style="text-align: center;"></col>
+                            <col style="text-align: center;"></col>
+                            <col style="text-align: center;"></col>
+                        </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 CF 1.0</th>
+                            <th>Mono 1.2</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></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>
+                        </tr>
+                        <tr class="b">
+                            <td>AspNetTraceAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</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>
+                        </tr>
+                        <tr class="b">
+                            <td>ColoredConsoleAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</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>
+                        </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>
+                        </tr>
+                        <tr class="a">
+                            <td>EventLogAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</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>
+                        </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>
+                        </tr>
+                        <tr class="b">
+                            <td>LocalSyslogAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="a">
+                            <td>MemoryAppender</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>NetSendAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                        </tr>
+                        <tr class="a">
+                            <td>OutputDebugStringAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td></td>
+                            <td></td>
+                        </tr>
+                        <tr class="b">
+                            <td>RemoteSyslogAppender</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>RemotingAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>RollingFileAppender</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>SmtpAppender</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                            <td></td>
+                            <td>x</td>
+                        </tr>
+                        <tr class="b">
+                            <td>SmtpPickupDirAppender</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>TelnetAppender</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>TraceAppender</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>UdpAppender</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="Framework Specific Notes"></a><div class="section"><h2>Framework Specific Notes</h2>
+                <a name="Microsoft .NET Framework 1.0 (1.0.3705)"></a><div class="section"><h2>Microsoft .NET Framework 1.0 (1.0.3705)</h2>
+                    <p>
+                        none
+                    </p>
+                </div>
+                
+                <a name="Microsoft .NET Framework 1.1 (1.1.4322)"></a><div class="section"><h2>Microsoft .NET Framework 1.1 (1.1.4322)</h2>
+                    <p>
+                        none
+                    </p>
+                </div>
+                
+                <a name="Microsoft .NET Framework 2.0 (2.0.50727)"></a><div class="section"><h2>Microsoft .NET Framework 2.0 (2.0.50727)</h2>
+                    <p>
+                        none
+                    </p>
+                </div>
+                
+                <a name="Microsoft .NET Compact Framework 1.0"></a><div class="section"><h2>Microsoft .NET Compact Framework 1.0</h2>
+                    <ul>
+                        <li>
+                            <h4>Assembly attributes</h4>
+                            
+                                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>
+                                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>
+                            <pre class="code">
+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>
+                        </li>
+                        <li>
+                            <h4>Notification events</h4>
+                            
+                                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>
+                                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>
+                        </li>
+                        <li>
+                            <h4>FileSystemWatcher</h4>
+                            
+                                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.
+                            
+                        </li>
+                        <li>
+                            <h4>UserName</h4>
+                            
+                                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>.
+                            
+                        </li>
+                        <li>
+                            <h4>Identity</h4>
+                            
+                                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>.
+                            
+                        </li>
+                        <li>
+                            <h4>Environment variables</h4>
+                            
+                                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.
+                            
+                        </li>
+                        <li>
+                            <h4>Serialization</h4>
+                            
+                                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.
+                            
+                        </li>
+                        <li>
+                            <h4>LoggingEvent.Domain</h4>
+                            
+                                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.
+                            
+                        </li>
+                    </ul>
+                </div>
+                
+                <a name="Mono"></a><div class="section"><h2>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="Mono 1.0"></a><div class="section"><h2>Mono 1.0</h2>
+                        <p>
+                            none
+                        </p>
+                    </div>
+                    <a name="Mono 2.0"></a><div class="section"><h2>Mono 2.0</h2>
+                        <p>
+                            none
+                        </p>
+                    </div>
+                    
+                </div>
+                
+                <a name="Microsoft Shared Source CLI 1.0"></a><div class="section"><h2>Microsoft Shared Source CLI 1.0</h2>
+                    <ul>
+                        <li>
+                            <h4>FileSystemWatcher</h4>
+                            
+                                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.
+                            
+                        </li>
+                        <li>
+                            <h4>UserName</h4>
+                            
+                                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>.
+                            
+                        </li>
+                        <li>
+                            <h4>Identity</h4>
+                            
+                                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>.
+                            
+                        </li>
+                    </ul>
+                </div>
+                
+                <a name="CLI 1.0 Compatible"></a><div class="section"><h2>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>
+                    
+                        Only a Release build is generated for this configuration because the assembly
+                        debugging information has not been standardized.
+                    
+                </div>
+                
+            </div>
+            
+        </div>
+        
+    
+
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">&#169;  
+          2007
+    
+          Apache Software Foundation
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Propchange: logging/site/trunk/docs/log4net/release/framework-support.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: logging/site/trunk/docs/log4net/release/howto/chainsaw.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4net/release/howto/chainsaw.html?view=auto&rev=559716
==============================================================================
--- logging/site/trunk/docs/log4net/release/howto/chainsaw.html (added)
+++ logging/site/trunk/docs/log4net/release/howto/chainsaw.html Wed Jul 25 23:41:40 2007
@@ -0,0 +1,285 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+  <head>
+    <title>Apache log4net - 
+        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 http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+      </head>
+  <body class="composite">
+    <div id="banner">
+                  <a href="http://logging.apache.org/" id="bannerLeft">
+    
+                                            <img src="../../images/ls-logo.jpg" alt="" />
+    
+            </a>
+                    <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+          
+  
+
+  
+    
+  
+  
+            <div class="xleft">
+        Last Published: 07/26/2007
+                          |   
+          <a href="http://www.apache.org/">Apache</a>
+              &gt;
+      
+          <a href="http://logging.apache.org/">Logging Services</a>
+              &gt;
+      
+          <a href="../../">log4net</a>
+                        </div>
+            <div class="xright">      
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+           
+  
+
+  
+    
+  
+  
+                   <h5>Get log4net</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../download.html">Download</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../changes-report.html">Changes</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../license.html">License</a>
+        </li>
+          </ul>
+          <h5>About log4net</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../index.html">What is log4net?</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../faq.html">FAQ</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../roadmap.html">Roadmap</a>
+        </li>
+          </ul>
+          <h5>Community</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../mail-lists.html">Mailing Lists</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../issue-tracking.html">Issue Tracking</a>
+        </li>
+          </ul>
+          <h5>Development</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../source-repository.html">Repository</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../integration.html">Continuous Integration</a>
+        </li>
+          </ul>
+          <h5>Documentation</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../release/manual/introduction.html">Introduction</a>
+        </li>
+          </ul>
+          <h5>Apache</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="http://www.apache.org">Home</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apachecon.com">Conferences</a>
+        </li>
+          </ul>
+                                       <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+            <img alt="Built by Maven" src="../../images/logos/maven-feather.png"></img>
+          </a>
+                       
+  
+
+  
+    
+  
+  
+        </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        
+
+    
+
+    <meta name="keywords" content="chainsaw log4net, log4net"></meta>
+
+    
+        <a name="How To view logging events using Apache log4j Chainsaw"></a><div class="section"><h2>How To view logging events using Apache log4j Chainsaw</h2>
+            <sectionMenu name="Contents"></sectionMenu>
+            
+            <p>
+                Apache log4j includes <a href="http://logging.apache.org/log4j/docs/chainsaw.html">Chainsaw</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></br>
+                Save one or more of the sample xml config files to your local system and 
+                load them when Chainsaw starts.
+            </p>
+            
+            <a name="Logging via UDP"></a><div class="section"><h2>Logging via UDP</h2>
+                <p>
+                    log4net can be configured to log messages via UDP in such a way that Chainsaw
+                    can receive and display them.
+                </p>
+            
+                <a name="log4net UDP Configuration"></a><div class="section"><h2>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="Chainsaw UDP receiver Configuration"></a><div class="section"><h2>Chainsaw UDP receiver Configuration</h2>
+                    <p>
+                        Chainsaw should be configured to start a <c>UDPReceiver</c> 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="Logging to XML file"></a><div class="section"><h2>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">&#169;  
+          2007
+    
+          Apache Software Foundation
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Propchange: logging/site/trunk/docs/log4net/release/howto/chainsaw.html
------------------------------------------------------------------------------
    svn:mime-type = text/html

Added: logging/site/trunk/docs/log4net/release/howto/index.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4net/release/howto/index.html?view=auto&rev=559716
==============================================================================
--- logging/site/trunk/docs/log4net/release/howto/index.html (added)
+++ logging/site/trunk/docs/log4net/release/howto/index.html Wed Jul 25 23:41:40 2007
@@ -0,0 +1,221 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+
+
+
+
+
+
+
+
+
+<html>
+  <head>
+    <title>Apache log4net - 
+        Apache log4net: How Tos</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 http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
+      </head>
+  <body class="composite">
+    <div id="banner">
+                  <a href="http://logging.apache.org/" id="bannerLeft">
+    
+                                            <img src="../../images/ls-logo.jpg" alt="" />
+    
+            </a>
+                    <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="breadcrumbs">
+          
+  
+
+  
+    
+  
+  
+            <div class="xleft">
+        Last Published: 07/26/2007
+                          |   
+          <a href="http://www.apache.org/">Apache</a>
+              &gt;
+      
+          <a href="http://logging.apache.org/">Logging Services</a>
+              &gt;
+      
+          <a href="../../">log4net</a>
+                        </div>
+            <div class="xright">      
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+    <div id="leftColumn">
+      <div id="navcolumn">
+           
+  
+
+  
+    
+  
+  
+                   <h5>Get log4net</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../download.html">Download</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../changes-report.html">Changes</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../license.html">License</a>
+        </li>
+          </ul>
+          <h5>About log4net</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../index.html">What is log4net?</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../faq.html">FAQ</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../roadmap.html">Roadmap</a>
+        </li>
+          </ul>
+          <h5>Community</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../mail-lists.html">Mailing Lists</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../issue-tracking.html">Issue Tracking</a>
+        </li>
+          </ul>
+          <h5>Development</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../source-repository.html">Repository</a>
+        </li>
+              
+    <li class="none">
+              <a href="../../integration.html">Continuous Integration</a>
+        </li>
+          </ul>
+          <h5>Documentation</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="../../release/manual/introduction.html">Introduction</a>
+        </li>
+          </ul>
+          <h5>Apache</h5>
+        <ul>
+              
+    <li class="none">
+              <a href="http://www.apache.org">Home</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+        </li>
+              
+    <li class="none">
+              <a href="http://www.apachecon.com">Conferences</a>
+        </li>
+          </ul>
+                                       <a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy">
+            <img alt="Built by Maven" src="../../images/logos/maven-feather.png"></img>
+          </a>
+                       
+  
+
+  
+    
+  
+  
+        </div>
+    </div>
+    <div id="bodyColumn">
+      <div id="contentBox">
+        
+
+    
+
+    <meta name="keywords" content="howto log4net, log4net"></meta>
+
+    
+        <a name="log4net How Tos"></a><div class="section"><h2>log4net How Tos</h2>
+            
+            <p>
+                Below are presented, in no particular order, a series of documents
+                on how to get stuff done.
+            </p>
+            <p>
+                New documents can be contributed via the issue tracking system.
+                See the <a href="../../contributing.html">Contributing</a> page for
+                details.
+            </p>
+
+            <ul>
+                <li>
+                    <a href="chainsaw.html">How To view logging events using Apache log4j Chainsaw</a>
+                </li>
+                
+            </ul>        
+
+        </div>
+    
+
+      </div>
+    </div>
+    <div class="clear">
+      <hr/>
+    </div>
+    <div id="footer">
+      <div class="xright">&#169;  
+          2007
+    
+          Apache Software Foundation
+          
+  
+
+  
+    
+  
+  
+  </div>
+      <div class="clear">
+        <hr/>
+      </div>
+    </div>
+  </body>
+</html>

Propchange: logging/site/trunk/docs/log4net/release/howto/index.html
------------------------------------------------------------------------------
    svn:mime-type = text/html



Mime
View raw message