Author: carnold Date: Fri Mar 28 18:19:42 2008 New Revision: 642470 URL: http://svn.apache.org/viewvc?rev=642470&view=rev Log: log4cxx 0.10.0-rc6 Modified: logging/site/trunk/docs/log4cxx/building/ant.html logging/site/trunk/docs/log4cxx/building/autotools.html logging/site/trunk/docs/log4cxx/building/maven.html logging/site/trunk/docs/log4cxx/building/vstudio.html logging/site/trunk/docs/log4cxx/building/xcode.html logging/site/trunk/docs/log4cxx/download.html logging/site/trunk/docs/log4cxx/faq.html logging/site/trunk/docs/log4cxx/index.html logging/site/trunk/docs/log4cxx/stylesheets/project.html Modified: logging/site/trunk/docs/log4cxx/building/ant.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/ant.html?rev=642470&r1=642469&r2=642470&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/building/ant.html (original) +++ logging/site/trunk/docs/log4cxx/building/ant.html Fri Mar 28 18:19:42 2008 @@ -27,6 +27,40 @@ See the License for the specific language governing permissions and limitations under the License. +--> log4cxx - Building Apache log4cxx with Apache Ant @@ -217,13 +251,13 @@

Building Apache log4cxx with Apache Ant

-

Apache Ant - with cpptasks from the Ant-Contrib +

Apache Ant + with cpptasks from the Ant-Contrib 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.

Quick start:

-
  • Install Apache Ant +
    • Install Apache Ant 1.6.5 or later.
    • -
    • Install cpptasks 1.0b5 or later from the Ant-Contrib Project +
    • Install cpptasks 1.0b5 or later from the Ant-Contrib Project . ant-contribs 1.0b3 or later is needed for some less frequent build targets.
    • Install APR and APR-Util or place source in apr and apr-util directories as a sibling to the log4cxx directory.
    • Install gzip and zip (used for compression by RollingFileAppender) and sed (used to normalize output files for comparison in unit tests).
    • @@ -352,11 +386,11 @@

      Properties may also be placed in a build.properties file in the log4cxx directory.

Platform specific notes:

-
  • Microsoft Windows

    GnuWin32 - provides binary versions of sed, gzip and zip. Alternative, the bin directory of Cygwin +

    • Microsoft Windows

      GnuWin32 + provides binary versions of sed, gzip and zip. Alternative, the bin directory of Cygwin may be placed on the path.

      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.

      -

      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 44327 +

      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 44327 . APR 1.2.11 and the corresponding APR-Util 1.2.10 will compile with Visual Studio 6.

    • Cygwin:

      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.

      @@ -378,7 +412,7 @@ $ ..\..\..\target\debug\shared\trivial $ ..\..\..\target\debug\shared\stream
-

Running "ant check" was observed to fail with unexpected exceptions in streamtestcase and datetimedateformattestcase. See LOGCXX-244 +

Running "ant check" was observed to fail with unexpected exceptions in streamtestcase and datetimedateformattestcase. See LOGCXX-244 .

  • Debian:

    Apache APR, APR-Util, Ant and log4j and zip may be installed using:

    Modified: logging/site/trunk/docs/log4cxx/building/autotools.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/autotools.html?rev=642470&r1=642469&r2=642470&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/building/autotools.html (original) +++ logging/site/trunk/docs/log4cxx/building/autotools.html Fri Mar 28 18:19:42 2008 @@ -27,6 +27,40 @@ See the License for the specific language governing permissions and limitations under the License. +--> log4cxx - Building Apache log4cxx with autotools @@ -307,7 +341,7 @@ --with-apr-util=/usr/local --with-logchar=wchar_t $ make install
  • -

    Running "make check" was observed to fail with unexpected exceptions in streamtestcase and datetimedateformattestcase. See LOGCXX-244 +

    Running "make check" was observed to fail with unexpected exceptions in streamtestcase and datetimedateformattestcase. See LOGCXX-244 .

    Modified: logging/site/trunk/docs/log4cxx/building/maven.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/maven.html?rev=642470&r1=642469&r2=642470&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/building/maven.html (original) +++ logging/site/trunk/docs/log4cxx/building/maven.html Fri Mar 28 18:19:42 2008 @@ -27,6 +27,40 @@ See the License for the specific language governing permissions and limitations under the License. +--> log4cxx - Building Apache log4cxx with Apache Maven 2 @@ -217,11 +251,11 @@

    Building Apache log4cxx with Apache Maven 2

    -

    Apache Maven 2 +

    Apache Maven 2 is used to generate the release assemblies and generate product documentation. It delegates to the Apache Ant build 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.

    Quick start:

    -
    • Install Apache Maven +
      • Install Apache Maven 2.0.8 or later.
      • Install APR and APR-Util or place source in apr and apr-util directories in same parent directory as log4cxx directory.

        Building and testing log4cxx on a Unix platform with packaged APR and APR-Util.

         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=642470&r1=642469&r2=642470&view=diff
        ==============================================================================
        --- logging/site/trunk/docs/log4cxx/building/vstudio.html (original)
        +++ logging/site/trunk/docs/log4cxx/building/vstudio.html Fri Mar 28 18:19:42 2008
        @@ -27,6 +27,40 @@
          See the License for the specific language governing permissions and
          limitations under the License.
         
        +-->
           
             log4cxx - Building Apache log4cxx with Microsoft Visual Studio
        @@ -240,7 +274,7 @@
         

        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.

        Known Issues

        -
        • 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 44327 +
          • 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 44327 . APR 1.2.11 and the corresponding APR-Util 1.2.10 will compile with Visual Studio 6.
          • 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.
          • APR-Iconv is problematic and not used by log4cxx, it can be disabled in apu.hw.
          • Modified: logging/site/trunk/docs/log4cxx/building/xcode.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/building/xcode.html?rev=642470&r1=642469&r2=642470&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/building/xcode.html (original) +++ logging/site/trunk/docs/log4cxx/building/xcode.html Fri Mar 28 18:19:42 2008 @@ -27,6 +27,40 @@ See the License for the specific language governing permissions and limitations under the License. +--> log4cxx - Building Apache log4cxx with Apple Xcode @@ -220,24 +254,23 @@

            Building log4cxx.dylib

            Run configure to generate log4cxx.h and log4cxx_private.h then launch Xcode.

            cd apache-log4cxx-0.10.0
            -./autogen.sh
             ./configure
             open projects/log4cxx.xcodeproj

            Running unit tests

            -

            Generate include files are previously described, open projects/testsuite.xcodeproj or projects/testsuite-standalone.xcodeproj (test suite and implementation in one project) in Xcode and address issues described below.

            -

            Select the executable in Groups & Files and press Info and:

            +

            Run configure then open projects/testsuite.xcodeproj or projects/testsuite-standalone.xcodeproj (test suite and implementation in one project) in Xcode.

            +

            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:

            • In the General pane, set Working Directory to Custom with path "../src/test/resources".
            • In the Arguments pane, add following key value pairs to "Variables to be set in the environment": TOTO=wonderful, key1=value1 and key2=value2.
            • In the Arguments pane, add "-v" for verbose output, or individual test names in "Arguments to be passed on launch".

            Issues

            -

            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.

            -

            See issue LOGCXX-245 +

            The project file generation does does not properly 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.

            +

            See issue LOGCXX-245 for further information.

            -

            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".

            +

            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".

        Modified: logging/site/trunk/docs/log4cxx/download.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/download.html?rev=642470&r1=642469&r2=642470&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/download.html (original) +++ logging/site/trunk/docs/log4cxx/download.html Fri Mar 28 18:19:42 2008 @@ -27,6 +27,40 @@ See the License for the specific language governing permissions and limitations under the License. +--> log4cxx - Download Apache log4cxx 0.10.0 @@ -217,7 +251,7 @@

        Download Apache log4cxx 0.10.0

        -

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

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

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

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

        Please read Verifying Apache HTTP Server Releases +

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

        Previous Releases

        -

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

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

        Modified: logging/site/trunk/docs/log4cxx/faq.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/faq.html?rev=642470&r1=642469&r2=642470&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/faq.html (original) +++ logging/site/trunk/docs/log4cxx/faq.html Fri Mar 28 18:19:42 2008 @@ -27,6 +27,40 @@ See the License for the specific language governing permissions and limitations under the License. +--> log4cxx - Frequently Asked Technical Questions Modified: logging/site/trunk/docs/log4cxx/index.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/index.html?rev=642470&r1=642469&r2=642470&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/index.html (original) +++ logging/site/trunk/docs/log4cxx/index.html Fri Mar 28 18:19:42 2008 @@ -27,6 +27,40 @@ See the License for the specific language governing permissions and limitations under the License. +--> log4cxx - Short introduction to Apache log4cxx @@ -221,16 +255,16 @@

        Introduction

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

        Almost every large application includes its own logging or tracing Modified: logging/site/trunk/docs/log4cxx/stylesheets/project.html URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4cxx/stylesheets/project.html?rev=642470&r1=642469&r2=642470&view=diff ============================================================================== --- logging/site/trunk/docs/log4cxx/stylesheets/project.html (original) +++ logging/site/trunk/docs/log4cxx/stylesheets/project.html Fri Mar 28 18:19:42 2008 @@ -27,6 +27,40 @@ See the License for the specific language governing permissions and limitations under the License. +--> log4cxx -