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 ca...@apache.org on 2008/02/12 22:25:48 UTC
svn commit: r627117 - in /logging/log4cxx/trunk: INSTALL
src/site/apt/building/ src/site/apt/building/ant.apt
src/site/apt/building/autotools.apt src/site/apt/building/maven.apt
src/site/apt/building/vstudio.apt src/site/apt/building/xcode.apt
Author: carnold
Date: Tue Feb 12 13:25:47 2008
New Revision: 627117
URL: http://svn.apache.org/viewvc?rev=627117&view=rev
Log:
LOGCXX-72: Add build instructions to site, have INSTALL point to them
Added:
logging/log4cxx/trunk/src/site/apt/building/
logging/log4cxx/trunk/src/site/apt/building/ant.apt
logging/log4cxx/trunk/src/site/apt/building/autotools.apt
logging/log4cxx/trunk/src/site/apt/building/maven.apt
logging/log4cxx/trunk/src/site/apt/building/vstudio.apt
logging/log4cxx/trunk/src/site/apt/building/xcode.apt
Modified:
logging/log4cxx/trunk/INSTALL
Modified: logging/log4cxx/trunk/INSTALL
URL: http://svn.apache.org/viewvc/logging/log4cxx/trunk/INSTALL?rev=627117&r1=627116&r2=627117&view=diff
==============================================================================
--- logging/log4cxx/trunk/INSTALL (original)
+++ logging/log4cxx/trunk/INSTALL Tue Feb 12 13:25:47 2008
@@ -12,6 +12,34 @@
See the License for the specific language governing permissions and
limitations under the License.
+
+Detailed build instructions are provided for in both HTML
+and APT format in releases. The APT sources are
+available in Subversion checkouts.
+
+autotools:
+site/building/autotools.html
+src/site/apt/building/autotools.apt
+
+Apache Ant:
+site/building/ant.html
+src/site/apt/building/ant.apt
+
+Apache Maven 2:
+site/building/maven.html
+src/site/apt/building/maven.apt
+
+Microsoft Visual Studio:
+site/building/vstudio.html
+src/site/apt/building/vstudio.apt
+
+Apple Xcode:
+site/building/xcode.html
+src/site/apt/building/xcode.apt
+
+
+
+
Introduction
============
Apache log4cxx is a C++ transliteration of Apache log4j.
@@ -126,193 +154,4 @@
-
-autotools
-==================
-
-
- The file `configure.in' is used to create `configure' by a program
-called `autoconf'.
-
-The simplest way to compile this package is:
-
- 1. `cd' to the directory containing the package's source code.
-
- 2. type `./autogen.sh' to generate the configure script.
- If you're using `csh' on an old version of System V, you might
- need to type `sh ./autogen.sh' instead to prevent `csh' from trying
- to execute `autogen.sh' itself.
-
- 3. type `./configure' to configure the package for your system.
- If you're using `csh' on an old version of System V, you might
- need to type `sh ./configure' instead to prevent `csh' from trying
- to execute `configure' itself.
-
- Running `configure' takes awhile. While running, it prints some
- messages telling which features it is checking for.
-
- 4. Type `make' to compile the package.
-
- 5. Optionally, type `make check' to run self-tests.
-
- 6. Type `sudo make install' to install the programs and any data files and
- documentation.
-
- 7. You can remove the program binaries and object files from the
- source code directory by typing `make clean'. To also remove the
- files that `configure' created (so you can compile the package for
- a different kind of computer), type `make distclean'. There is
- also a `make maintainer-clean' target, but that is intended mainly
- for the package's developers. If you use it, you may have to get
- all sorts of other programs in order to regenerate files that came
- with the distribution.
-
-Compilers and Options
-=====================
-
- Some systems require unusual options for compilation or linking that
-the `configure' script does not know about. You can give `configure'
-initial values for variables by setting them in the environment. Using
-a Bourne-compatible shell, you can do that on the command line like
-this:
- CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
-
-Or on systems that have the `env' program, you can do it like this:
- env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
-
-Compiling For Multiple Architectures
-====================================
-
- You can compile the package for more than one kind of computer at the
-same time, by placing the object files for each architecture in their
-own directory. To do this, you must use a version of `make' that
-supports the `VPATH' variable, such as GNU `make'. `cd' to the
-directory where you want the object files and executables to go and run
-the `configure' script. `configure' automatically checks for the
-source code in the directory that `configure' is in and in `..'.
-
- If you have to use a `make' that does not supports the `VPATH'
-variable, you have to compile the package for one architecture at a time
-in the source code directory. After you have installed the package for
-one architecture, use `make distclean' before reconfiguring for another
-architecture.
-
-Installation Names
-==================
-
- By default, `make install' will install the package's files in
-`/usr/local/bin', `/usr/local/man', etc. You can specify an
-installation prefix other than `/usr/local' by giving `configure' the
-option `--prefix=PATH'.
-
- You can specify separate installation prefixes for
-architecture-specific files and architecture-independent files. If you
-give `configure' the option `--exec-prefix=PATH', the package will use
-PATH as the prefix for installing programs and libraries.
-Documentation and other data files will still use the regular prefix.
-
- In addition, if you use an unusual directory layout you can give
-options like `--bindir=PATH' to specify different values for particular
-kinds of files. Run `configure --help' for a list of the directories
-you can set and what kinds of files go in them.
-
- If the package supports it, you can cause programs to be installed
-with an extra prefix or suffix on their names by giving `configure' the
-option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
-
-Configure options
-=================
-
---with-apr : Specify non-default location for apr.
---with-aprutil: Specify non-default location for apr-util.
---enable-wchar_t: Enable wchar_t API methods.
---enable-unichar: Enable UniChar API methods, UniChar is an unsigned short containing UTF-16.
---enable-cfstring: Enable CFString API methods, CFString is Mac OS/X CoreFoundation's string.
---with-logchar= utf-8 | wchar_t | unichar: Specify internal character type.
---with-charset = utf-8 | iso-8859-1 | usascii | ebcdic | auto: Specified fixed encoding.
-
-
-SMTP support (SMTPAppender) can be disabled through option --with-SMTP
- * "libesmtp": libesmtp library (http://www.stafford.uklinux.net/libesmtp/)
- * "no" (default): no SMTP support
-
---enable-doxygen : generate documentation using Doxygen
---enable-dot : use Dot to generate class diagrams for Doxygen
---enable-html-docs: generate HTML documentation with doxygen
---enable-latex-docs: generate Latex documentation with doxygen
-
-ODBC support (ODBCAppender) can be added through option --with-ODBC
- * "unixODBC" : unixODBC library (http://www.unixodbc.org)
- * "iODBC" : iODBC library (http://www.iodbc.org)
- * "Microsoft" : Microsoft ODBC library
- * "no" (default) : no ODBC support
-
-SMTP and ODBC support involving compiling and linking with
-that are not licensed under the Apache Software License.
-You should review the corresponding licenses and understand
-their implications before using those options.
-
-
-
-Specifying the System Type
-==========================
-
- There may be some features `configure' can not figure out
-automatically, but needs to determine by the type of host the package
-will run on. Usually `configure' can figure that out, but if it prints
-a message saying it can not guess the host type, give it the
-`--host=TYPE' option. TYPE can either be a short name for the system
-type, such as `sun4', or a canonical name with three fields:
- CPU-COMPANY-SYSTEM
-
-See the file `config.sub' for the possible values of each field. If
-`config.sub' isn't included in this package, then this package doesn't
-need to know the host type.
-
- If you are building compiler tools for cross-compiling, you can also
-use the `--target=TYPE' option to select the type of system they will
-produce code for and the `--build=TYPE' option to select the type of
-system on which you are compiling the package.
-
-Sharing Defaults
-================
-
- If you want to set default values for `configure' scripts to share,
-you can create a site shell script called `config.site' that gives
-default values for variables like `CC', `cache_file', and `prefix'.
-`configure' looks for `PREFIX/share/config.site' if it exists, then
-`PREFIX/etc/config.site' if it exists. Or, you can set the
-`CONFIG_SITE' environment variable to the location of the site script.
-A warning: not all `configure' scripts look for a site script.
-
-Operation Controls
-==================
-
- `configure' recognizes the following options to control how it
-operates.
-
-`--cache-file=FILE'
- Use and save the results of the tests in FILE instead of
- `./config.cache'. Set FILE to `/dev/null' to disable caching, for
- debugging `configure'.
-
-`--help'
- Print a summary of the options to `configure', and exit.
-
-`--quiet'
-`--silent'
-`-q'
- Do not print messages saying which checks are being made. To
- suppress all normal output, redirect it to `/dev/null' (any error
- messages will still be shown).
-
-`--srcdir=DIR'
- Look for the package's source code in directory DIR. Usually
- `configure' can determine that directory automatically.
-
-`--version'
- Print the version of Autoconf used to generate the `configure'
- script, and exit.
-
-`configure' also accepts some other, not widely useful, options.
Added: logging/log4cxx/trunk/src/site/apt/building/ant.apt
URL: http://svn.apache.org/viewvc/logging/log4cxx/trunk/src/site/apt/building/ant.apt?rev=627117&view=auto
==============================================================================
--- logging/log4cxx/trunk/src/site/apt/building/ant.apt (added)
+++ logging/log4cxx/trunk/src/site/apt/building/ant.apt Tue Feb 12 13:25:47 2008
@@ -0,0 +1,161 @@
+~~ 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.
+ ------
+ Building Apache log4cxx with Apache Ant
+ ------
+ ------
+ ------
+
+
+Building Apache log4cxx with Apache Ant
+
+ 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 {{{http://ant.apache.org}Apache Ant}} 1.6.5 or later.
+
+ *Install cpptasks 1.0b5 or later from the {{{http://ant-contrib.sourceforge.net}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 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-dev libaprutil1-dev ant ant-optional liblog4j1.2-java # or platform equivalent
+ export CLASSPATH=/home/myself/cpptasks-1.0b5/cpptasks.jar:/home/myself/ant-contrib/ant-contrib-1.0b3.jar
+ cd apache-log4cxx-0.10.0
+ ant
++----+
+
+ Building and testing log4cxx on a Unix platform with APR and APR-Util built from source.
+
++----+
+ sudo apt-get install ant ant-optional liblog4j1.2-java # or platform equivalent
+ export CLASSPATH=/home/myself/cpptasks-1.0b5/cpptasks.jar:/home/myself/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
++----+
+
+ Building and testing log4cxx on a Microsoft Windows with APR and APR-Util built from source.
+
++----+
+ set PATH=\apache-ant-1.7.0\bin;%PATH%
+ set CLASSPATH=\cpptasks-1.0b5\cpptasks.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
++----+
+
+
+
+
+
+* Common ant targets
+
+*-----------------------+---------------------------------------------------------------------------------------------+
+| build | build log4cxx library. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| check | build logcxx library and build and run unit tests and examples. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| clean | Delete all generated files. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| build-unittest | build log4cxx library and unit test. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| run-socketserver | Tests SocketAppender with Java-based receiver. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| build-projects-vc6 | Build Microsoft Visual Studio 6 project files. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| build-projects-vc7 | Build Microsoft Visual Studio .NET project files. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| build-projects-vc8 | Build Microsoft Visual Studio 2005 project files. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| build-projects-vc9 | Build Microsoft Visual Studio 2008 project files. |
+*-----------------------+---------------------------------------------------------------------------------------------+
+| build-projects-xcode | Build Apple Xcode project files. |
+*---------------------+-----------------------------------------------------------------------------------------------+
+
+ All build products will be placed in the target subdirectory.
+
+ 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.
+
+
+* ant options
+
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dcompiler | Compiler, see cpptasks documentation for full list. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Ddebug | Build for debugging, yes (default), no. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dwith-apr | path to non-default location for APR. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dwith-apr-util | path to non-default location for APR-Util. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Denable-wchar_t | Enable wchar_t API methods, choice of yes (default), no. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Denable-unichar | Enable UniChar API methods, choice of yes, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Denable-cfstring | Enable CFString API methods, requires Mac OS/X CoreFoundation, choice of yes, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dwith-logchar | Interal character representation, choice of utf-8 (default), wchar_t , unichar. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dwith-charset | Exteral character encoding, choice of utf-8, iso-8859-1, usascii, ebcdic, auto (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dwith-SMTP | SMTP implementation for SMTPAppender, choice of libesmtp, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dwith-ODBC | OBDC implementation for ODBCAppender, choice of unixODBC, iODBC, Microsoft, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dlog4j.jar | Path to log4j.jar for run-socketserver. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -Dprojects.dir | Location for generated IDE projects. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -p | Display available targets and quit. |
+*-------------------+---------------------------------------------------------------------------------------------+
+
+
+ SMTP and ODBC support may depend on libraries that are
+ that are not licensed under the Apache Software License.
+ You should review the corresponding licenses and understand
+ the implications before redistribution.
+
+ Properties may also be placed in a build.properties file in the log4cxx directory.
+
+* Platform specific notes:
+
+ ** Mac OS/X:
+
+ APR, APR-Util and iODBC are preinstalled in Mac OS/X 10.5 and later.
+
+ ** Cygwin:
+
+ ** MinGW:
Added: logging/log4cxx/trunk/src/site/apt/building/autotools.apt
URL: http://svn.apache.org/viewvc/logging/log4cxx/trunk/src/site/apt/building/autotools.apt?rev=627117&view=auto
==============================================================================
--- logging/log4cxx/trunk/src/site/apt/building/autotools.apt (added)
+++ logging/log4cxx/trunk/src/site/apt/building/autotools.apt Tue Feb 12 13:25:47 2008
@@ -0,0 +1,74 @@
+~~ 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.
+ ------
+ Building Apache log4cxx with autotools
+ ------
+ ------
+ ------
+
+Building Apache log4cxx with autotools
+
+* Quick start:
+
++------------+
+ sudo apt-get install libapr1-dev libaprutil1-dev # or platform equivalent
+ cd apache-log4cxx-0.10.0
+ ./autoconf.sh
+ ./configure
+ make
+ make check
+ sudo make install
++------------+
+
+
+* configure options
+
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-apr | path to non-default location for APR. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-apr-util | path to non-default location for APR-Util. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --enable-wchar_t | Enable wchar_t API methods, choice of yes (default), no. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --enable-unichar | Enable UniChar API methods, choice of yes, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --enable-cfstring | Enable CFString API methods, requires Mac OS/X CoreFoundation, choice of yes, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-logchar | Interal character representation, choice of utf-8 (default), wchar_t , unichar. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-charset | Exteral character encoding, choice of utf-8, iso-8859-1, usascii, ebcdic, auto (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-SMTP | SMTP implementation for SMTPAppender, choice of libesmtp, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-ODBC | OBDC implementation for ODBCAppender, choice of unixODBC, iODBC, Microsoft, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -help | Display help showing all options and exit. |
+*-------------------+---------------------------------------------------------------------------------------------+
+
+
+ SMTP and ODBC support may depend on libraries that are
+ that are not licensed under the Apache Software License.
+ You should review the corresponding licenses and understand
+ the implications before redistribution.
+
+* Platform specific notes:
+
+** Mac OS/X:
+
+ APR, APR-Util and iODBC are preinstalled in Mac OS/X 10.5 and later.
+
+** Cygwin:
+
+** MinGW:
Added: logging/log4cxx/trunk/src/site/apt/building/maven.apt
URL: http://svn.apache.org/viewvc/logging/log4cxx/trunk/src/site/apt/building/maven.apt?rev=627117&view=auto
==============================================================================
--- logging/log4cxx/trunk/src/site/apt/building/maven.apt (added)
+++ logging/log4cxx/trunk/src/site/apt/building/maven.apt Tue Feb 12 13:25:47 2008
@@ -0,0 +1,107 @@
+~~ 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.
+ ------
+ Building Apache log4cxx with Apache Maven 2
+ ------
+ ------
+ ------
+
+
+Building Apache log4cxx with 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 {{{http://maven.apache.org}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-dev libaprutil1-dev doxygen # or platform equivalent
+ cd apache-log4cxx-0.10.0
+ export PATH=/home/myself/maven-2.0.8/bin:$PATH
+ mvn package
++----+
+
+
+ Building and testing log4cxx on a Microsoft Windows with APR and APR-Util built from source.
+
++----+
+ 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
++----+
+
+
+
+
+
+* Common Maven targets
+
+*--------------------------+---------------------------------------------------------------------------------------------+
+| compile | build log4cxx library. |
+*--------------------------+---------------------------------------------------------------------------------------------+
+| package | build logcxx library and build and run unit tests and examples. |
+*--------------------------+---------------------------------------------------------------------------------------------+
+| site | Generate documentation and IDE project files, requires doxygen. |
+*--------------------------+---------------------------------------------------------------------------------------------+
+| site assembly:assembly | Generate snapshot tarball and zip file. |
+*--------------------------+---------------------------------------------------------------------------------------------+
+| site-deploy | Publish website to staging area on ASF subversion repository (requires credentials). |
+*--------------------------+---------------------------------------------------------------------------------------------+
+| clean | Delete all generated files. |
+*--------------------------+---------------------------------------------------------------------------------------------+
+
+ All build products will be placed in the target subdirectory.
+
+ It is not possible to directly pass options to the Ant build, however the ant build will read
+ any build.properties file in the log4cxx directory.
+
+ SMTP and ODBC support may depend on libraries that are
+ that are not licensed under the Apache Software License.
+ You should review the corresponding licenses and understand
+ the implications before redistribution.
+
+* Platform specific notes:
+
+ ** Mac OS/X:
+
+ APR, APR-Util and iODBC are preinstalled in Mac OS/X 10.5 and later.
+
+ Site generation requires "doxygen" command on path which can be provided
+ by installing Doxygen.app and then setting the path like:
+
+ +---+
+ setenv PATH /Applications/Doxygen.app/Content/Resources:$PATH
+ +---+
+
+
+ ** Cygwin:
+
+ ** MinGW:
Added: logging/log4cxx/trunk/src/site/apt/building/vstudio.apt
URL: http://svn.apache.org/viewvc/logging/log4cxx/trunk/src/site/apt/building/vstudio.apt?rev=627117&view=auto
==============================================================================
--- logging/log4cxx/trunk/src/site/apt/building/vstudio.apt (added)
+++ logging/log4cxx/trunk/src/site/apt/building/vstudio.apt Tue Feb 12 13:25:47 2008
@@ -0,0 +1,75 @@
+~~ 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.
+ ------
+ Building Apache log4cxx with Microsoft Visual Studio
+ ------
+ ------
+ ------
+
+Building Apache log4cxx with Microsoft Visual Studio (TODO)
+
+
+* Quick start:
+
++------------+
+ sudo apt-get install libapr1-dev libaprutil1-dev # or platform equivalent
+ cd apache-log4cxx-0.10.0
+ ./autoconf.sh
+ ./configure
+ make
+ make check
+ sudo make install
++------------+
+
+
+* configure options
+
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-apr | path to non-default location for APR. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-apr-util | path to non-default location for APR-Util. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --enable-wchar_t | Enable wchar_t API methods, choice of yes (default), no. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --enable-unichar | Enable UniChar API methods, choice of yes, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --enable-cfstring | Enable CFString API methods, requires Mac OS/X CoreFoundation, choice of yes, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-logchar | Interal character representation, choice of utf-8 (default), wchar_t , unichar. |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-charset | Exteral character encoding, choice of utf-8, iso-8859-1, usascii, ebcdic, auto (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-SMTP | SMTP implementation for SMTPAppender, choice of libesmtp, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| --with-ODBC | OBDC implementation for ODBCAppender, choice of unixODBC, iODBC, Microsoft, no (default). |
+*-------------------+---------------------------------------------------------------------------------------------+
+| -help | Display help showing all options and exit. |
+*-------------------+---------------------------------------------------------------------------------------------+
+
+
+ SMTP and ODBC support may depend on libraries that are
+ that are not licensed under the Apache Software License.
+ You should review the corresponding licenses and understand
+ the implications before redistribution.
+
+* Platform specific notes:
+
+ ** Mac OS/X:
+
+ APR, APR-Util and iODBC are preinstalled in Mac OS/X 10.5 and later.
+
+ ** Cygwin:
+
+ ** MinGW:
Added: logging/log4cxx/trunk/src/site/apt/building/xcode.apt
URL: http://svn.apache.org/viewvc/logging/log4cxx/trunk/src/site/apt/building/xcode.apt?rev=627117&view=auto
==============================================================================
--- logging/log4cxx/trunk/src/site/apt/building/xcode.apt (added)
+++ logging/log4cxx/trunk/src/site/apt/building/xcode.apt Tue Feb 12 13:25:47 2008
@@ -0,0 +1,68 @@
+~~ 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.
+ ------
+ Building Apache log4cxx with Apple Xcode
+ ------
+ ------
+ ------
+
+Building Apache log4cxx with Apple Xcode
+
+*Building log4cxx.dylib
+
+ Open projects/log4cxx.xcodeproj with Xcode, address issues described below
+ and build as normal.
+
+*Running unit tests
+
+ 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
+
+ * 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.
+
+ Individual tests can be specified by specifying the test name in
+ "Arguments to be passed on launch".
+
+*Issues
+
+ [[1]] 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:
+
+ Create symbolic links to the libraries in some arbitary directory:
+
+ +-----+
+ 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
+ +------+
+
+ Then add the arbitary directory to the Library Search Paths
+ (Build tab of the Get Info page for the project).
+
+
+ [[2]] 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.