You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@logging.apache.org by ca...@apache.org on 2008/03/28 19:36:35 UTC
svn commit: r642326 [12/14] - in /logging/site/trunk/docs/log4cxx: ./
apidocs/ building/ stylesheets/
Modified: logging/site/trunk/docs/log4cxx/apidocs/triggeringpolicy_8h.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/apidocs/triggeringpolicy_8h.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/apidocs/triggeringpolicy_8h.html (original)
+++ logging/site/trunk/docs/log4cxx/apidocs/triggeringpolicy_8h.html Fri Mar 28 11:36:20 2008
@@ -51,6 +51,9 @@
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="triggeringpolicy_8h.html#db0d489ad865791221a60d31b50d3778">_LOG4CXX_ROLLING_TRIGGER_POLICY_H</a></td></tr>
+<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
+<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="namespacelog4cxx_1_1rolling.html#18dabbed6db8575b969ce430b319d05a">log4cxx::rolling::LOG4CXX_PTR_DEF</a> (TriggeringPolicy)</td></tr>
+
</table>
<hr><h2>Define Documentation</h2>
<a class="anchor" name="db0d489ad865791221a60d31b50d3778"></a><!-- doxytag: member="triggeringpolicy.h::_LOG4CXX_ROLLING_TRIGGER_POLICY_H" ref="db0d489ad865791221a60d31b50d3778" args="" --><p>
Modified: logging/site/trunk/docs/log4cxx/building/ant.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/ant.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/building/ant.html (original)
+++ logging/site/trunk/docs/log4cxx/building/ant.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
<div class="xleft">
- Last Published: 2008-02-23
+ Last Published: 2008-03-28
|
<a href="http://www.apache.org/" class="externalLink">Apache</a>
>
@@ -217,42 +217,39 @@
<div id="bodyColumn">
<div id="contentBox">
<div class="section"><h2>Building Apache log4cxx with Apache Ant</h2>
-<p><a href="http://ant.apache.org" class="externalLink">Apache Ant</a>
- with cpptasks from the <a href="http://ant-contrib.sourceforge.net" class="externalLink">Ant-Contrib</a>
+<p><a class="externalLink" href="http://ant.apache.org">Apache Ant</a>
+ with cpptasks from the <a class="externalLink" href="http://ant-contrib.sourceforge.net">Ant-Contrib</a>
project can be used to build log4cxx with supported compilers and is also used to generate the IDE project files included in the releases. The Apache Maven build which is used to generate the site documentation and release packaging delegates to this build. The Ant build can build APR and APR-Util if source is available.</p>
<div class="section"><h3>Quick start:</h3>
-<ul><li>Install <a href="http://ant.apache.org" class="externalLink">Apache Ant</a>
+<ul><li>Install <a class="externalLink" href="http://ant.apache.org">Apache Ant</a>
1.6.5 or later.</li>
-<li>Install cpptasks 1.0b5 or later from the <a href="http://ant-contrib.sourceforge.net" class="externalLink">Ant-Contrib Project</a>
+<li>Install cpptasks 1.0b5 or later from the <a class="externalLink" href="http://ant-contrib.sourceforge.net">Ant-Contrib Project</a>
. ant-contribs 1.0b3 or later is needed for some less frequent build targets.</li>
-<li>Install APR and APR-Util or place source in apr and apr-util directories as a sibling to the log4cxx directory.<p>Building and testing log4cxx on a Unix platform with packaged APR and APR-Util. </p>
-<div class="source"><pre> sudo apt-get install libapr1.0-dev libaprutil1.0-dev \
- ant ant-optional liblog4j1.2-java
- export CLASSPATH=~/cpptasks/cpptasks-1.0b5.jar: \
- ~/ant-contrib/ant-contrib-1.0b3.jar
- cd apache-log4cxx-0.10.0
- ant</pre>
+<li>Install APR and APR-Util or place source in apr and apr-util directories as a sibling to the log4cxx directory.</li>
+<li>Install gzip and zip (used for compression by RollingFileAppender) and sed (used to normalize output files for comparison in unit tests).</li>
+<li>Install log4j 1.2. Used in testing of SocketAppender. <p>Building and testing log4cxx on a Unix platform with packaged APR and APR-Util. </p>
+<div class="source"><pre>$ export CLASSPATH=~/cpptasks/cpptasks-1.0b5.jar
+$ cd apache-log4cxx-0.10.0
+$ ant</pre>
</div>
<p>Building and testing log4cxx on a Unix platform with APR and APR-Util built from source. </p>
-<div class="source"><pre> sudo apt-get install ant ant-optional liblog4j1.2-java
- export CLASSPATH=~/cpptasks/cpptasks-1.0b5.jar: \
- ~/ant-contrib/ant-contrib-1.0b3.jar
- tar -xvzf apr-1.2.12.tar.gz
- mv apr-1.2.12 apr
- tar -xvzf apr-util-1.2.12.tar.gz
- mv apr-util-1.2.12 apr-util
- cd apache-log4cxx-0.10.0
- ant</pre>
+<div class="source"><pre>$ export CLASSPATH=~/cpptasks/cpptasks-1.0b5.jar
+$ tar -xvzf apr-1.2.12.tar.gz
+$ mv apr-1.2.12 apr
+$ tar -xvzf apr-util-1.2.12.tar.gz
+$ mv apr-util-1.2.12 apr-util
+$ cd apache-log4cxx-0.10.0
+$ ant</pre>
</div>
<p>Building and testing log4cxx on a Microsoft Windows with APR and APR-Util built from source. </p>
-<div class="source"><pre> set PATH=\apache-ant-1.7.0\bin;%PATH%
- set CLASSPATH=\cpptasks\cpptasks-1.0b5.jar;\ant-contrib\ant-contrib-1.0b3.jar
- tar -xvzf apr-1.2.12.tar.gz
- rename apr-1.2.12 apr
- tar -xvzf apr-util-1.2.12.tar.gz
- rename apr-util-1.2.12 apr-util
- cd apache-log4cxx-0.10.0
- ant -Dfind=false</pre>
+<div class="source"><pre>set PATH=\apache-ant-1.7.0\bin;%PATH%
+set CLASSPATH=\cpptasks\cpptasks-1.0b5.jar
+tar -xvzf apr-1.2.12.tar.gz
+rename apr-1.2.12 apr
+tar -xvzf apr-util-1.2.12.tar.gz
+rename apr-util-1.2.12 apr-util
+cd apache-log4cxx-0.10.0
+ant -Dfind=false</pre>
</div>
</li>
</ul>
@@ -336,43 +333,62 @@
<tr class="b"><td align="left">-Dprojects.dir</td>
<td align="left">Location for generated IDE projects.</td>
</tr>
-<tr class="a"><td align="left">-p</td>
+<tr class="a"><td align="left">-Dlib.type</td>
+<td align="left">Library type to create, choice of shared (default), static.</td>
+</tr>
+<tr class="b"><td align="left">-Druntime</td>
+<td align="left">Type of C runtime library to use, choice of dynamic (default), static.</td>
+</tr>
+<tr class="a"><td align="left">-Doptimization</td>
+<td align="left">Optimization: none (default), size, minimal, speed, full, aggressive, extreme, unsafe.</td>
+</tr>
+<tr class="b"><td align="left">-p</td>
<td align="left">Display available targets and quit.</td>
</tr>
</tbody>
</table>
<p>SMTP and ODBC options can depend on libraries that that have different licenses. You should review the corresponding licenses and understand the implications before redistribution.</p>
+<p>Combining -Dlib.type=shared and -Druntime=static is unsafe.</p>
<p>Properties may also be placed in a build.properties file in the log4cxx directory.</p>
</div>
<div class="section"><h3>Platform specific notes:</h3>
-<ul><li>Microsoft Windows<p>A GNU sed command is required to be on the path to complete the unit tests. Cygwin's implementation is known to work.</p>
+<ul><li>Microsoft Windows<p><a class="externalLink" href="http://gnuwin32.sourceforge.net">GnuWin32</a>
+ provides binary versions of sed, gzip and zip. Alternative, the bin directory of <a class="externalLink" href="http://www.cygwin.com">Cygwin</a>
+ may be placed on the path.</p>
<p>If -Dwith-SMTP=libesmtp is specified, the build will attempt to build libesmtp from source, unfortunately libesmtp depends on poll.h and will not build.</p>
-<p>APR 1.2.12 has a known issue that will prevent compilation with Visual Studio 6 unless a later Platform SDK is installed. See APR bug <a href="http://issues.apache.org/bugzilla/show_bug.cgi?44327" class="externalLink">44327</a>
+<p>APR 1.2.12 has a known issue that will prevent compilation with Visual Studio 6 unless a later Platform SDK is installed. See APR bug <a class="externalLink" href="http://issues.apache.org/bugzilla/show_bug.cgi?44327">44327</a>
. APR 1.2.11 and the corresponding APR-Util 1.2.10 will compile with Visual Studio 6. </p>
</li>
<li>Cygwin:<p>gcc 3.x does not provide wchar_t support which needs to be explicitly disabled. The Win32 path to the APR libraries need to be provided (CYGWIN_HOME/lib) if compiling against an installed APR and APR-Util.</p>
-<div class="source"><pre>cd apache-log4cxx-0.10.0
-ant -Dos.family=cygwin -Dwith-apr=/cygwin/lib -Dwith-apr-util=/cygwin/lib \
+<div class="source"><pre>$ cd apache-log4cxx-0.10.0
+$ ant -Dos.family=cygwin \
+ -Dwith-apr=/cygwin/lib \
+ -Dwith-apr-util=/cygwin/lib \
-Denable-wchar_t=0</pre>
</div>
</li>
-<li>MinGW:<div class="source"><pre>cd apache-log4cxx-0.10.0
-path c:\mingw\bin;%PATH%
-ant -Dcompiler=gcc -Dfind=false build-all
-cd src\test\resources
-set TOTO=wonderful
-set key1=value1
-set key2=value2
-..\..\..\target\debug\shared\testsuite -v
-..\..\..\target\debug\shared\trivial
-..\..\..\target\debug\shared\stream </pre>
+<li>MinGW:<div class="source"><pre>$ cd apache-log4cxx-0.10.0
+$ path c:\mingw\bin;%PATH%
+$ ant -Dcompiler=gcc -Dfind=false build-all
+$ cd src\test\resources
+$ set TOTO=wonderful
+$ set key1=value1
+$ set key2=value2
+$ ..\..\..\target\debug\shared\testsuite -v
+$ ..\..\..\target\debug\shared\trivial
+$ ..\..\..\target\debug\shared\stream </pre>
</div>
-<p>Running "ant check" was observed to fail with unexpected exceptions in streamtestcase and datetimedateformattestcase. See <a href="http://issues.apache.org/jira/browse/LOGCXX-244" class="externalLink">LOGCXX-244</a>
+<p>Running "ant check" was observed to fail with unexpected exceptions in streamtestcase and datetimedateformattestcase. See <a class="externalLink" href="http://issues.apache.org/jira/browse/LOGCXX-244">LOGCXX-244</a>
.</p>
</li>
-<li>Mac OS/X:<p>APR, APR-Util and iODBC are preinstalled in Mac OS/X.</p>
+<li>Debian:<p>Apache APR, APR-Util, Ant and log4j and zip may be installed using:</p>
+<div class="source"><pre>$ sudo apt-get install libapr1.0-dev libaprutil1.0-dev \
+ ant ant-optional liblog4j1.2-java zip</pre>
+</div>
+</li>
+<li>Mac OS/X:<p>APR and APR-Util are provided by the platform in Mac OS/X 10.5 and iODBC in 10.4.</p>
<p>Site generation requires "doxygen" command on path which can be provided by installing Doxygen.app and then setting the path like:</p>
-<div class="source"><pre>setenv PATH /Applications/Doxygen.app/Contents/Resources:$PATH</pre>
+<div class="source"><pre>$ setenv PATH /Applications/Doxygen.app/Contents/Resources:$PATH</pre>
</div>
</li>
</ul>
Modified: logging/site/trunk/docs/log4cxx/building/autotools.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/autotools.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/building/autotools.html (original)
+++ logging/site/trunk/docs/log4cxx/building/autotools.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
<div class="xleft">
- Last Published: 2008-02-23
+ Last Published: 2008-03-28
|
<a href="http://www.apache.org/" class="externalLink">Apache</a>
>
@@ -218,13 +218,12 @@
<div id="contentBox">
<div class="section"><h2>Building Apache log4cxx with autotools</h2>
<div class="section"><h3>Quick start:</h3>
-<div class="source"><pre> sudo apt-get install libapr1.0-dev libaprutil1.0-dev
- cd apache-log4cxx-0.10.0
- ./autoconf.sh
- ./configure
- make
- make check
- sudo make install</pre>
+<p>Install or build apr 1.x, apr-util 1.x, gzip and zip.</p>
+<div class="source"><pre>$ cd apache-log4cxx-0.10.0
+$ ./configure
+$ make
+$ make check
+$ sudo make install</pre>
</div>
</div>
<div class="section"><h3>configure options</h3>
@@ -264,35 +263,51 @@
</div>
<div class="section"><h3>Platform specific notes:</h3>
<div class="section"><h4>Mac OS/X:</h4>
-<p>APR, APR-Util and iODBC are preinstalled in Mac OS/X 10.5 and later.</p>
+<p>APR and APR-Util are provided by the platform in Mac OS/X 10.5 and iODBC in 10.4.</p>
+</div>
+<div class="section"><h4>Debian:</h4>
+<p>APR, APR-Util and zip may be installed by:</p>
+<div class="source"><pre>$ sudo apt-get install libapr1.0-dev libaprutil1.0-dev zip</pre>
+</div>
+</div>
+<div class="section"><h4>FreeBSD:</h4>
+<p>APR, APR-Util and zip may be installed from the ports collection by:</p>
+<div class="source"><pre># cd /usr/ports/archivers/zip
+# make
+# make install
+# cd /usr/ports/devel/apr
+# make
+# make install</pre>
+</div>
</div>
<div class="section"><h4>Cygwin:</h4>
-<p>Install sed which is required by the unit tests. The prepackaged APR currently available from Cygwin has APR_HAS_THREADS == 0. Some appenders will not be available and some may operate with reduced functionality. There have been reports of building APR on Cygwin with threads enabled.</p>
+<p>Install zip (used by RollingFileAppender) and sed (used to normalize output files for comparison in the unit tests). The prepackaged APR currently available from Cygwin has APR_HAS_THREADS == 0. Some appenders will not be available and some may operate with reduced functionality. There have been reports of building APR on Cygwin with threads enabled.</p>
</div>
<div class="section"><h4>MinGW:</h4>
<p>Recent APR 1.2.x releases fail ./configure with a error of "decision on anonymous shared memory failed". That issue has been fixed in the current APR SVN HEAD. The follow sequence worked with MSYS (with Python on Path):</p>
-<div class="source"><pre>cd expat-2.0.1
-./configure
-make install
-cd ..
-svn co https://svn.apache.org/repos/asf/apr/apr/trunk apr
-cd apr
-./buildconf.sh
-./configure
-make install
-cd ..
-svn co https://svn.apache.org/repos/asf/apr/apr-util/trunk apr-util
-cd apr-util
-./buildconf.sh
-./configure --with-apr=/usr/local --with-expat=/usr/local
-make install
-cd ../apache-log4cxx-0.10.0
-./autogen.sh
-./configure --with-apr=/usr/local \
+<div class="source"><pre>$ cd expat-2.0.1
+$ ./configure
+$ make install
+$ cd ..
+$ svn co https://svn.apache.org/repos/asf/apr/apr/trunk apr
+$ cd apr
+$ ./buildconf.sh
+$ ./configure
+$ make install
+$ cd ..
+$ svn co \
+ https://svn.apache.org/repos/asf/apr/apr-util/trunk \
+ apr-util
+$ cd apr-util
+$ ./buildconf.sh
+$ ./configure --with-apr=/usr/local --with-expat=/usr/local
+$ make install
+$ cd ../apache-log4cxx-0.10.0
+$ ./configure --with-apr=/usr/local \
--with-apr-util=/usr/local --with-logchar=wchar_t
-make install</pre>
+$ make install</pre>
</div>
-<p>Running "make check" was observed to fail with unexpected exceptions in streamtestcase and datetimedateformattestcase. See <a href="http://issues.apache.org/jira/browse/LOGCXX-244" class="externalLink">LOGCXX-244</a>
+<p>Running "make check" was observed to fail with unexpected exceptions in streamtestcase and datetimedateformattestcase. See <a class="externalLink" href="http://issues.apache.org/jira/browse/LOGCXX-244">LOGCXX-244</a>
.</p>
</div>
</div>
Modified: logging/site/trunk/docs/log4cxx/building/maven.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/maven.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/building/maven.html (original)
+++ logging/site/trunk/docs/log4cxx/building/maven.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
<div class="xleft">
- Last Published: 2008-02-23
+ Last Published: 2008-03-28
|
<a href="http://www.apache.org/" class="externalLink">Apache</a>
>
@@ -217,11 +217,11 @@
<div id="bodyColumn">
<div id="contentBox">
<div class="section"><h2>Building Apache log4cxx with Apache Maven 2</h2>
-<p><a href="http://maven.apache.org" class="externalLink">Apache Maven 2</a>
+<p><a class="externalLink" href="http://maven.apache.org">Apache Maven 2</a>
is used to generate the release assemblies and generate product documentation. It delegates to the <a href="ant.html">Apache Ant build</a>
to build and test log4cxx and can be used as an alternate front end to the Ant build process since it can automatically download and use ant-contrib, cpptasks and log4j. The Maven build, like the Ant build, can build APR and APR-Util from source.</p>
<div class="section"><h3>Quick start:</h3>
-<ul><li>Install <a href="http://maven.apache.org" class="externalLink">Apache Maven</a>
+<ul><li>Install <a class="externalLink" href="http://maven.apache.org">Apache Maven</a>
2.0.8 or later.</li>
<li>Install APR and APR-Util or place source in apr and apr-util directories in same parent directory as log4cxx directory.<p>Building and testing log4cxx on a Unix platform with packaged APR and APR-Util. </p>
<div class="source"><pre> sudo apt-get install libapr1.0-dev libaprutil1.0-dev doxygen
Modified: logging/site/trunk/docs/log4cxx/building/vstudio.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/vstudio.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/building/vstudio.html (original)
+++ logging/site/trunk/docs/log4cxx/building/vstudio.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
<div class="xleft">
- Last Published: 2008-02-23
+ Last Published: 2008-03-28
|
<a href="http://www.apache.org/" class="externalLink">Apache</a>
>
@@ -235,12 +235,12 @@
<p>Select log4cxx as active project and build.</p>
</div>
<div class="section"><h3>Running unit tests</h3>
-<p>To pass the unit tests, sed must be on the path to normalize the generated output files. Also three environment variables need to be defined: TOTO=wonderful, key1=value1 and key2=value2. These must be done outside of Microsoft Visual Studio, either in the Control Panel or in a Command Prompt uses to launch Microsoft Visual Studio.</p>
+<p>To pass the unit tests, gzip, zip and sed must be on the path. Also three environment variables need to be defined: TOTO=wonderful, key1=value1 and key2=value2. These must be done outside of Microsoft Visual Studio, either in the Control Panel or in a Command Prompt uses to launch Microsoft Visual Studio.</p>
<p>Open projects/testsuite.dsw or projects/testsuite-standalone.dsw (test suite and implementation in one project) in Microsoft Visual Studio, select active project and build.</p>
<p>On the Debug Tab of the Project/Settings dialog, set the Working Directory to "../src/test/resources". Individual tests can be specified in Program Arguments and "-v" can be specified to output verbose test results.</p>
</div>
<div class="section"><h3>Known Issues</h3>
-<ul><li>APR 1.2.12 has a known issue that will prevent compilation with Visual Studio 6 unless a later Platform SDK is installed. See APR bug <a href="http://issues.apache.org/bugzilla/show_bug.cgi?44327" class="externalLink">44327</a>
+<ul><li>APR 1.2.12 has a known issue that will prevent compilation with Visual Studio 6 unless a later Platform SDK is installed. See APR bug <a class="externalLink" href="http://issues.apache.org/bugzilla/show_bug.cgi?44327">44327</a>
. APR 1.2.11 and the corresponding APR-Util 1.2.10 will compile with Visual Studio 6.</li>
<li>APR-Util requires later LDAP headers than provided with Visual Studio 6 and will fail to compile. log4cxx does not use LDAP, it can be disabled in apr_ldap.hw.</li>
<li>APR-Iconv is problematic and not used by log4cxx, it can be disabled in apu.hw.</li>
Modified: logging/site/trunk/docs/log4cxx/building/xcode.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/xcode.html?rev=642326&r1=642325&r2=642326&view=diff
==============================================================================
--- logging/site/trunk/docs/log4cxx/building/xcode.html (original)
+++ logging/site/trunk/docs/log4cxx/building/xcode.html Fri Mar 28 11:36:20 2008
@@ -59,7 +59,7 @@
<div class="xleft">
- Last Published: 2008-02-23
+ Last Published: 2008-03-28
|
<a href="http://www.apache.org/" class="externalLink">Apache</a>
>
@@ -234,17 +234,10 @@
</ul>
</div>
<div class="section"><h3>Issues</h3>
-<p>Xcode fails when linking to apr and aprutil dylibs in /usr/lib, however it will succeed linking to symbolic links to the same files. As a workaround until a resolution is found:</p>
-<p>Create symbolic links to the libraries in some arbitrary directory:</p>
-<div class="source"><pre>mkdir ~/apr-dylib
-cd ~/apr-dylib
-ln -s /usr/lib/libapr-1.dylib libapr-1.dylib
-ln -s /usr/lib/libaprutil-1.dylib libaprutil-1.dylib</pre>
-</div>
-<p>Then add the arbitary directory to the Library Search Paths (Build tab of the Get Info page for the project).</p>
<p>The project file generation does does not properly create an entry in the "Link Binary with Libraries" build phase for projects that depend on log4cxx. To work around the problem, open the project in Xcode and in the Groups & Files pane, drag log4cxx.dylib and drop on the "Link Binary with Libraries" folder under Targets.</p>
-<p>See issue <a href="http://issues.apache.org/jira/browse/LOGCXX-245" class="externalLink">LOGCXX-245</a>
+<p>See issue <a class="externalLink" href="http://issues.apache.org/jira/browse/LOGCXX-245">LOGCXX-245</a>
for further information.</p>
+<p>Thw generated projects us the Mac OS/X 10.5 SDK which provides APR and APR-Util. To generated XCode projects that do not use Mac OS/X, set up the ant build and then "ant build-projects-xcode".</p>
</div>
</div>