You are viewing a plain text version of this content. The canonical link for it is here.
Posted to log4cxx-dev@logging.apache.org by ts...@apache.org on 2014/01/23 16:21:34 UTC
svn commit: r1560715 [1/5] - in /incubator/log4cxx/site: ./ publish/
publish/log4cxx-0.11.0-SNAPSHOT/ publish/log4cxx-0.11.0-SNAPSHOT/building/
publish/log4cxx-0.11.0-SNAPSHOT/css/
publish/log4cxx-0.11.0-SNAPSHOT/images/ publish/log4cxx-0.11.0-SNAPSHOT...
Author: tschoening
Date: Thu Jan 23 15:21:33 2014
New Revision: 1560715
URL: http://svn.apache.org/r1560715
Log:
INFRA-7209: Committed the old website into our repo because of changes how it gets published in the future.
Added:
incubator/log4cxx/site/
incubator/log4cxx/site/publish/
incubator/log4cxx/site/publish/.htaccess
incubator/log4cxx/site/publish/0.x
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/ant.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/autotools.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/maven.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/vstudio.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/xcode.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/changes-report.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/css/
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/css/maven-base.css
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/css/maven-theme.css
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/css/site.css
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/dependencies.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/download.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/faq.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/add.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/close.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/external.png (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/fix.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/icon_error_sml.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/icon_help_sml.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/icon_info_sml.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/icon_success_sml.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/icon_warning_sml.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/logos/
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/logos/ls-logo.jpg (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/logos/maven-feather.png (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/ls-logo.jpg (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/newwindow.png (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/od.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/remove.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/rss.png (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/images/update.gif (with props)
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/index.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/issue-tracking.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/license.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/mail-lists.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/project-info.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/project-reports.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/source-repository.html
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/stylesheets/
incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/stylesheets/project.html
Added: incubator/log4cxx/site/publish/.htaccess
URL: http://svn.apache.org/viewvc/incubator/log4cxx/site/publish/.htaccess?rev=1560715&view=auto
==============================================================================
--- incubator/log4cxx/site/publish/.htaccess (added)
+++ incubator/log4cxx/site/publish/.htaccess Thu Jan 23 15:21:33 2014
@@ -0,0 +1,3 @@
+RewriteEngine on
+RewriteCond %{REQUEST_URI} !^/log4cxx/log4cxx-0.11.0-SNAPSHOT.*$
+RewriteRule ^(.*)$ /log4cxx/log4cxx-0.11.0-SNAPSHOT/$1
Added: incubator/log4cxx/site/publish/0.x
URL: http://svn.apache.org/viewvc/incubator/log4cxx/site/publish/0.x?rev=1560715&view=auto
==============================================================================
--- incubator/log4cxx/site/publish/0.x (added)
+++ incubator/log4cxx/site/publish/0.x Thu Jan 23 15:21:33 2014
@@ -0,0 +1 @@
+link log4cxx-0.11.0-SNAPSHOT/
\ No newline at end of file
Added: incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/ant.html
URL: http://svn.apache.org/viewvc/incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/ant.html?rev=1560715&view=auto
==============================================================================
--- incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/ant.html (added)
+++ incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/ant.html Thu Jan 23 15:21:33 2014
@@ -0,0 +1,199 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ 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.
+
+-->
+<!-- Generated by Apache Maven Doxia at Jul 7, 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>Building Apache log4cxx with Apache Ant</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="Date-Revision-yyyymmdd" content="20120707" />
+ <meta http-equiv="Content-Language" content="en" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://logging.apache.org/" id="bannerLeft">
+ <img src="../images/ls-logo.jpg" alt="Logging Services" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2012-07-07</span>
+ | <span id="projectVersion">Version: 0.11.0-SNAPSHOT</span>
+ | <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ >
+ <a href="http://logging.apache.org/" class="externalLink" title="Logging Services">Logging Services</a>
+ >
+ <a href=".././" title="log4cxx">log4cxx</a>
+ </div>
+ <div class="xright">
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>Get Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../changes-report.html" title="Changes">Changes</a>
+ </li>
+ <li class="none">
+ <a href="../license.html" title="License">License</a>
+ </li>
+ </ul>
+ <h5>About Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="What is log4cxx?">What is log4cxx?</a>
+ </li>
+ <li class="none">
+ <a href="../apidocs/index.html" title="API Documentation">API Documentation</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</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>
+ <li class="none">
+ <a href="http://wiki.apache.org/logging-log4cxx" class="externalLink" title="Wiki">Wiki</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="../source-repository.html" title="Repository">Repository</a>
+ </li>
+ <li class="expanded">
+ <a href="../#" title="Building">Building</a>
+ <ul>
+ <li class="none">
+ <a href="../building/autotools.html" title="autotools">autotools</a>
+ </li>
+ <li class="none">
+ <strong>Apache Ant</strong>
+ </li>
+ <li class="none">
+ <a href="../building/maven.html" title="Apache Maven 2">Apache Maven 2</a>
+ </li>
+ <li class="none">
+ <a href="../building/vstudio.html" title="Microsoft Visual Studio">Microsoft Visual Studio</a>
+ </li>
+ <li class="none">
+ <a href="../building/xcode.html" title="Apple Xcode">Apple Xcode</a>
+ </li>
+ </ul>
+ </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/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.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. --><div class="section"><h2>Building Apache log4cxx with Apache Ant<a name="Building_Apache_log4cxx_with_Apache_Ant"></a></h2><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:<a name="Quick_start:"></a></h3><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 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 dire
ctory.</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>$ 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
+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></div><div class="section"><h3>Common ant targets<a name="Common_ant_targets"></a></h3><table border="1" class="bodyTable"><tr class="a"><td align="left">build</td><td align="left">build log4cxx library.</td></tr><tr class="b"><td align="left">check</td><td align="left">build logcxx library and build and run unit tests and examples.</td></tr><tr class="a"><td align="left">clean</td><td align="left">Delete all generated files.</td></tr><tr class="b"><td align="left">build-unittest</td><td align="left">build log4cxx library and unit test.</td></tr><tr class="a"><td align="left">run-socketserver</td><td align="left">Tests SocketAppender with Java-based receiver.</td></tr><tr class="b"><td align="left">build-projects-vc6</td><td align="left">Build Microsoft Visual Studio 6 project files.</td></tr><tr class="a"><td align="left">build-projects-vc7</td><td align="left">Build Microsoft Visual Studio .NET project files.</td></tr><tr class="b"><td align="
left">build-projects-vc8</td><td align="left">Build Microsoft Visual Studio 2005 project files.</td></tr><tr class="a"><td align="left">build-projects-vc9</td><td align="left">Build Microsoft Visual Studio 2008 project files.</td></tr><tr class="b"><td align="left">build-projects-xcode</td><td align="left">Build Apple Xcode project files.</td></tr></table><p>All build products will be placed in the target subdirectory. </p><p>Project files should be generated after successfully building the library, however it is possible to generate Microsoft Visual Studio project files on other platforms. The project files will typically be missing references to the Platform SDK libraries. The Maven project modifies the generated project files for release preparation. Generation of Xcode projects from Microsoft Windows is not supported.</p></div><div class="section"><h3>ant options<a name="ant_options"></a></h3><table border="1" class="bodyTable"><tr class="a"><td align="left">-Dcompiler</td><td a
lign="left">Compiler, see cpptasks documentation for full list.</td></tr><tr class="b"><td align="left">-Ddebug</td><td align="left">Build for debugging, yes (default), no.</td></tr><tr class="a"><td align="left">-Dfind</td><td align="left">Attempt to locate compiled APR and APR-Util, yes (default), no.</td></tr><tr class="b"><td align="left">-Dwith-apr</td><td align="left">path to non-default location for APR.</td></tr><tr class="a"><td align="left">-Dwith-apr-util</td><td align="left">path to non-default location for APR-Util.</td></tr><tr class="b"><td align="left">-Denable-wchar_t</td><td align="left">Enable wchar_t API methods, choice of yes (default), no.</td></tr><tr class="a"><td align="left">-Denable-unichar</td><td align="left">Enable UniChar API methods, choice of yes, no (default).</td></tr><tr class="b"><td align="left">-Denable-cfstring</td><td align="left">Enable CFString API methods, requires Mac OS/X CoreFoundation, choice of yes, no (default).</td></tr><tr class="a
"><td align="left">-Dwith-logchar</td><td align="left">Interal character representation, choice of utf-8 (default), wchar_t , unichar.</td></tr><tr class="b"><td align="left">-Dwith-charset</td><td align="left">Exteral character encoding, choice of utf-8, iso-8859-1, usascii, ebcdic, auto (default).</td></tr><tr class="a"><td align="left">-Dwith-SMTP</td><td align="left">SMTP implementation for SMTPAppender, choice of libesmtp, no (default).</td></tr><tr class="b"><td align="left">-Dwith-ODBC</td><td align="left">OBDC implementation for ODBCAppender, choice of unixODBC, iODBC, Microsoft, no (default).</td></tr><tr class="a"><td align="left">-Dlog4j.jar</td><td align="left">Path to log4j.jar for run-socketserver.</td></tr><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">-Dlib.type</td><td align="left">Library type to create, choice of shared (default), static.</td></tr><tr class="b"><td ali
gn="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></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:<a name="Platform_specific_notes:"></a></h3><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 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 \
+ -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></div><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>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></li></ul></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xleft">Copyright © 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>
+ <div class="xleft">Apache log4cxx, Apache, 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">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/autotools.html
URL: http://svn.apache.org/viewvc/incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/autotools.html?rev=1560715&view=auto
==============================================================================
--- incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/autotools.html (added)
+++ incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/autotools.html Thu Jan 23 15:21:33 2014
@@ -0,0 +1,199 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ 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.
+
+-->
+<!-- Generated by Apache Maven Doxia at Jul 7, 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>Building Apache log4cxx with autotools</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="Date-Revision-yyyymmdd" content="20120707" />
+ <meta http-equiv="Content-Language" content="en" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://logging.apache.org/" id="bannerLeft">
+ <img src="../images/ls-logo.jpg" alt="Logging Services" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2012-07-07</span>
+ | <span id="projectVersion">Version: 0.11.0-SNAPSHOT</span>
+ | <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ >
+ <a href="http://logging.apache.org/" class="externalLink" title="Logging Services">Logging Services</a>
+ >
+ <a href=".././" title="log4cxx">log4cxx</a>
+ </div>
+ <div class="xright">
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>Get Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../changes-report.html" title="Changes">Changes</a>
+ </li>
+ <li class="none">
+ <a href="../license.html" title="License">License</a>
+ </li>
+ </ul>
+ <h5>About Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="What is log4cxx?">What is log4cxx?</a>
+ </li>
+ <li class="none">
+ <a href="../apidocs/index.html" title="API Documentation">API Documentation</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</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>
+ <li class="none">
+ <a href="http://wiki.apache.org/logging-log4cxx" class="externalLink" title="Wiki">Wiki</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="../source-repository.html" title="Repository">Repository</a>
+ </li>
+ <li class="expanded">
+ <a href="../#" title="Building">Building</a>
+ <ul>
+ <li class="none">
+ <strong>autotools</strong>
+ </li>
+ <li class="none">
+ <a href="../building/ant.html" title="Apache Ant">Apache Ant</a>
+ </li>
+ <li class="none">
+ <a href="../building/maven.html" title="Apache Maven 2">Apache Maven 2</a>
+ </li>
+ <li class="none">
+ <a href="../building/vstudio.html" title="Microsoft Visual Studio">Microsoft Visual Studio</a>
+ </li>
+ <li class="none">
+ <a href="../building/xcode.html" title="Apple Xcode">Apple Xcode</a>
+ </li>
+ </ul>
+ </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/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.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. --><div class="section"><h2>Building Apache log4cxx with autotools<a name="Building_Apache_log4cxx_with_autotools"></a></h2><div
class="section"><h3>Quick start:<a name="Quick_start:"></a></h3><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<a name="configure_options"></a></h3><table border="1" class="bodyTable"><tr class="a"><td align="left">--with-apr</td><td align="left">path to non-default location for APR.</td></tr><tr class="b"><td align="left">--with-apr-util</td><td align="left">path to non-default location for APR-Util.</td></tr><tr class="a"><td align="left">--enable-wchar_t</td><td align="left">Enable wchar_t API methods, choice of yes (default), no.</td></tr><tr class="b"><td align="left">--enable-unichar</td><td align="left">Enable UniChar API methods, choice of yes, no (default).</td></tr><tr class="a"><td align="left">--enable-cfstring</td><td align="left">Enable CFString API methods, requires Mac OS/X CoreFoundation, choice of yes, no (default).</td></tr><tr class="b"><td align="left">--with-logchar</td><td align="left">Interal character representation, choice of utf-8 (default), wchar_t , unichar.</td></tr><tr class="a"><td
align="left">--with-charset</td><td align="left">Exteral character encoding, choice of utf-8, iso-8859-1, usascii, ebcdic, auto (default).</td></tr><tr class="b"><td align="left">--with-SMTP</td><td align="left">SMTP implementation for SMTPAppender, choice of libesmtp, no (default).</td></tr><tr class="a"><td align="left">--with-ODBC</td><td align="left">OBDC implementation for ODBCAppender, choice of unixODBC, iODBC, Microsoft, no (default).</td></tr><tr class="b"><td align="left">-help</td><td align="left">Display help showing all options and exit.</td></tr></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></div><div class="section"><h3>Platform specific notes:<a name="Platform_specific_notes:"></a></h3><div class="section"><h4>Mac OS/X:<a name="Mac_OSX:"></a></h4><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:<a name="Debian:"></a></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:<a name="FreeBSD:"></a></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:<a name="Cygwin:"></a></h4><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:<a name="MinGW:"></a></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
+$ ./configure --with-apr=/usr/local \
+ --with-apr-util=/usr/local --with-logchar=wchar_t
+$ make install</pre></div><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></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xleft">Copyright © 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>
+ <div class="xleft">Apache log4cxx, Apache, 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">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/maven.html
URL: http://svn.apache.org/viewvc/incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/maven.html?rev=1560715&view=auto
==============================================================================
--- incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/maven.html (added)
+++ incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/maven.html Thu Jan 23 15:21:33 2014
@@ -0,0 +1,179 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ 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.
+
+-->
+<!-- Generated by Apache Maven Doxia at Jul 7, 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>Building Apache log4cxx with Apache Maven 2</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="Date-Revision-yyyymmdd" content="20120707" />
+ <meta http-equiv="Content-Language" content="en" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://logging.apache.org/" id="bannerLeft">
+ <img src="../images/ls-logo.jpg" alt="Logging Services" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2012-07-07</span>
+ | <span id="projectVersion">Version: 0.11.0-SNAPSHOT</span>
+ | <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ >
+ <a href="http://logging.apache.org/" class="externalLink" title="Logging Services">Logging Services</a>
+ >
+ <a href=".././" title="log4cxx">log4cxx</a>
+ </div>
+ <div class="xright">
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>Get Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../changes-report.html" title="Changes">Changes</a>
+ </li>
+ <li class="none">
+ <a href="../license.html" title="License">License</a>
+ </li>
+ </ul>
+ <h5>About Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="What is log4cxx?">What is log4cxx?</a>
+ </li>
+ <li class="none">
+ <a href="../apidocs/index.html" title="API Documentation">API Documentation</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</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>
+ <li class="none">
+ <a href="http://wiki.apache.org/logging-log4cxx" class="externalLink" title="Wiki">Wiki</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="../source-repository.html" title="Repository">Repository</a>
+ </li>
+ <li class="expanded">
+ <a href="../#" title="Building">Building</a>
+ <ul>
+ <li class="none">
+ <a href="../building/autotools.html" title="autotools">autotools</a>
+ </li>
+ <li class="none">
+ <a href="../building/ant.html" title="Apache Ant">Apache Ant</a>
+ </li>
+ <li class="none">
+ <strong>Apache Maven 2</strong>
+ </li>
+ <li class="none">
+ <a href="../building/vstudio.html" title="Microsoft Visual Studio">Microsoft Visual Studio</a>
+ </li>
+ <li class="none">
+ <a href="../building/xcode.html" title="Apple Xcode">Apple Xcode</a>
+ </li>
+ </ul>
+ </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/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.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. --><div class="section"><h2>Building Apache log4cxx with Apache Maven 2<a name="Building_Apache_log4cxx_with_Apache_Maven_2"></a>
</h2><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:<a name="Quick_start:"></a></h3><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
+ cd apache-log4cxx-0.10.0
+ export PATH=/home/myself/maven-2.0.8/bin:$PATH
+ mvn package</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=\maven-2.0.8\bin;%PATH%
+ 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
+ mvn package</pre></div></li></ul></div><div class="section"><h3>Common Maven targets<a name="Common_Maven_targets"></a></h3><table border="1" class="bodyTable"><tr class="a"><td align="left">compile</td><td align="left">build log4cxx library.</td></tr><tr class="b"><td align="left">package</td><td align="left">build logcxx library and build and run unit tests and examples.</td></tr><tr class="a"><td align="left">site</td><td align="left">Generate documentation and IDE project files, requires doxygen.</td></tr><tr class="b"><td align="left">site assembly:assembly</td><td align="left">Generate snapshot tarball and zip file.</td></tr><tr class="a"><td align="left">site-deploy</td><td align="left">Publish website to staging area on ASF subversion repository (requires credentials).</td></tr><tr class="b"><td align="left">clean</td><td align="left">Delete all generated files.</td></tr></table><p>All build products will be placed in the target subdirectory. </p><p>It is not possible to di
rectly pass options to the Ant build, however the ant build will read any build.properties file in the log4cxx directory.</p><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></div><div class="section"><h3>Platform specific notes:<a name="Platform_specific_notes:"></a></h3><p>See the <a href="#ant.html">Apache Ant build</a> for platform specific notes. </p></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xleft">Copyright © 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>
+ <div class="xleft">Apache log4cxx, Apache, 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">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/vstudio.html
URL: http://svn.apache.org/viewvc/incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/vstudio.html?rev=1560715&view=auto
==============================================================================
--- incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/vstudio.html (added)
+++ incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/vstudio.html Thu Jan 23 15:21:33 2014
@@ -0,0 +1,176 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ 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.
+
+-->
+<!-- Generated by Apache Maven Doxia at Jul 7, 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>Building Apache log4cxx with Microsoft Visual Studio</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="Date-Revision-yyyymmdd" content="20120707" />
+ <meta http-equiv="Content-Language" content="en" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://logging.apache.org/" id="bannerLeft">
+ <img src="../images/ls-logo.jpg" alt="Logging Services" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2012-07-07</span>
+ | <span id="projectVersion">Version: 0.11.0-SNAPSHOT</span>
+ | <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ >
+ <a href="http://logging.apache.org/" class="externalLink" title="Logging Services">Logging Services</a>
+ >
+ <a href=".././" title="log4cxx">log4cxx</a>
+ </div>
+ <div class="xright">
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>Get Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../changes-report.html" title="Changes">Changes</a>
+ </li>
+ <li class="none">
+ <a href="../license.html" title="License">License</a>
+ </li>
+ </ul>
+ <h5>About Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="What is log4cxx?">What is log4cxx?</a>
+ </li>
+ <li class="none">
+ <a href="../apidocs/index.html" title="API Documentation">API Documentation</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</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>
+ <li class="none">
+ <a href="http://wiki.apache.org/logging-log4cxx" class="externalLink" title="Wiki">Wiki</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="../source-repository.html" title="Repository">Repository</a>
+ </li>
+ <li class="expanded">
+ <a href="../#" title="Building">Building</a>
+ <ul>
+ <li class="none">
+ <a href="../building/autotools.html" title="autotools">autotools</a>
+ </li>
+ <li class="none">
+ <a href="../building/ant.html" title="Apache Ant">Apache Ant</a>
+ </li>
+ <li class="none">
+ <a href="../building/maven.html" title="Apache Maven 2">Apache Maven 2</a>
+ </li>
+ <li class="none">
+ <strong>Microsoft Visual Studio</strong>
+ </li>
+ <li class="none">
+ <a href="../building/xcode.html" title="Apple Xcode">Apple Xcode</a>
+ </li>
+ </ul>
+ </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/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.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. --><div class="section"><h2>Building Apache log4cxx with Microsoft Visual Studio<a name="Building_Apache_log4cxx_with_Microsoft_V
isual_Studio"></a></h2><div class="section"><h3>Preparation<a name="Preparation"></a></h3><div class="source"><pre>unzip apr-1.2.11-win32-src.zip
+rename apr-1.2.11 apr
+unzip apr-util-1.2.10-win32-src.zip
+rename apr-util-1.2.10 apr-util
+cd apache-log4cxx-0.10.0
+configure
+configure-aprutil</pre></div><p>configure.bat copies the prefabricated log4cxx.hw and private/log4cxx_private.hw over to log4cxx.h and private/log4cxx_private.h.</p><p>configure-aprutil.bat uses "sed" to modify apu.hw and apr_ldap.hw to disable APR-Iconv and LDAP which are not necessary for log4cxx and problematic to build. If "sed" is not available, the modifications would be trivial to do in any text editor.</p><p>Use the Win32 source zips for APR and APR-Util to preserve the required line endings for the project files. Directories need to be renamed to "apr" and "apr-util" respectively.</p></div><div class="section"><h3>Building log4cxx.dll<a name="Building_log4cxx.dll"></a></h3><p>Open projects/log4cxx.dsw with Microsoft Visual Studio 6 or later at which time you may be prompted to upgrade the projects to the format used by your version of Microsoft Visual Studio.</p><p>Select log4cxx as active project and build.</p></div><div class="secti
on"><h3>Running unit tests<a name="Running_unit_tests"></a></h3><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<a name="Known_Issues"></a></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 insta
lled. 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></ul></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xleft">Copyright © 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>
+ <div class="xleft">Apache log4cxx, Apache, 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">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Added: incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/xcode.html
URL: http://svn.apache.org/viewvc/incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/xcode.html?rev=1560715&view=auto
==============================================================================
--- incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/xcode.html (added)
+++ incubator/log4cxx/site/publish/log4cxx-0.11.0-SNAPSHOT/building/xcode.html Thu Jan 23 15:21:33 2014
@@ -0,0 +1,172 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ 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.
+
+-->
+<!-- Generated by Apache Maven Doxia at Jul 7, 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>Building Apache log4cxx with Apple Xcode</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="Date-Revision-yyyymmdd" content="20120707" />
+ <meta http-equiv="Content-Language" content="en" />
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="http://logging.apache.org/" id="bannerLeft">
+ <img src="../images/ls-logo.jpg" alt="Logging Services" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xleft">
+ <span id="publishDate">Last Published: 2012-07-07</span>
+ | <span id="projectVersion">Version: 0.11.0-SNAPSHOT</span>
+ | <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
+ >
+ <a href="http://logging.apache.org/" class="externalLink" title="Logging Services">Logging Services</a>
+ >
+ <a href=".././" title="log4cxx">log4cxx</a>
+ </div>
+ <div class="xright">
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>Get Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../download.html" title="Download">Download</a>
+ </li>
+ <li class="none">
+ <a href="../changes-report.html" title="Changes">Changes</a>
+ </li>
+ <li class="none">
+ <a href="../license.html" title="License">License</a>
+ </li>
+ </ul>
+ <h5>About Apache log4cxx</h5>
+ <ul>
+ <li class="none">
+ <a href="../index.html" title="What is log4cxx?">What is log4cxx?</a>
+ </li>
+ <li class="none">
+ <a href="../apidocs/index.html" title="API Documentation">API Documentation</a>
+ </li>
+ <li class="none">
+ <a href="../faq.html" title="FAQ">FAQ</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>
+ <li class="none">
+ <a href="http://wiki.apache.org/logging-log4cxx" class="externalLink" title="Wiki">Wiki</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="../source-repository.html" title="Repository">Repository</a>
+ </li>
+ <li class="expanded">
+ <a href="../#" title="Building">Building</a>
+ <ul>
+ <li class="none">
+ <a href="../building/autotools.html" title="autotools">autotools</a>
+ </li>
+ <li class="none">
+ <a href="../building/ant.html" title="Apache Ant">Apache Ant</a>
+ </li>
+ <li class="none">
+ <a href="../building/maven.html" title="Apache Maven 2">Apache Maven 2</a>
+ </li>
+ <li class="none">
+ <a href="../building/vstudio.html" title="Microsoft Visual Studio">Microsoft Visual Studio</a>
+ </li>
+ <li class="none">
+ <strong>Apple Xcode</strong>
+ </li>
+ </ul>
+ </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/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.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. --><div class="section"><h2>Building Apache log4cxx with Apple Xcode<a name="Building_Apache_log4cxx_with_Apple_Xcode"></a></h2><
div class="section"><h3>Building log4cxx.dylib<a name="Building_log4cxx.dylib"></a></h3><p>Run configure to generate log4cxx.h and log4cxx_private.h then launch Xcode.</p><div class="source"><pre>cd apache-log4cxx-0.10.0
+./configure
+open projects/log4cxx.xcodeproj</pre></div></div><div class="section"><h3>Running unit tests<a name="Running_unit_tests"></a></h3><p>Run configure then open projects/testsuite.xcodeproj or projects/testsuite-standalone.xcodeproj (test suite and implementation in one project) in Xcode.</p><p>The unit tests require the working directory and several environment variables to be set. To set these, elect the executable in Groups & Files and press Info and:</p><ul><li>In the General pane, set Working Directory to Custom with path "../src/test/resources".</li><li>In the Arguments pane, add following key value pairs to "Variables to be set in the environment": TOTO=wonderful, key1=value1 and key2=value2.</li><li>In the Arguments pane, add "-v" for verbose output, or individual test names in "Arguments to be passed on launch".</li></ul></div><div class="section"><h3>Issues<a name="Issues"></a></h3><p>The project file generation does does not properl
y create an entry in the "Link Binary with Libraries" build phase for projects (such as the examples and unit tests) 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 class="externalLink" href="http://issues.apache.org/jira/browse/LOGCXX-245">LOGCXX-245</a> for further information.</p><p>The projects provided in the release target Mac OS/X 10.5 which provides preinstalled APR and APR-Util libraries. To generate XCode projects to target Mac OS/X 10.4, set up the ant build and then "ant build-projects-xcode -Dfind=false".</p></div></div>
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xleft">Copyright © 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>
+ <div class="xleft">Apache log4cxx, Apache, 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">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>