carnold 2005/03/09 16:35:52
Modified: . INSTALL Log: LOGCXX-73: Install out-of-date Revision Changes Path 1.9 +110 -32 logging-log4cxx/INSTALL Index: INSTALL =================================================================== RCS file: /home/cvs/logging-log4cxx/INSTALL,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- INSTALL 13 May 2004 21:24:34 -0000 1.8 +++ INSTALL 10 Mar 2005 00:35:52 -0000 1.9 @@ -1,6 +1,115 @@ -Basic Installation +Ant + cpptasks build: ================== +The Ant build script is the definitive build script for log4cxx and +is able to build log4cxx with (at least) gcc, Microsoft Visual C++ 6, 7, 7.1 +and Borland C++ 5.5 and produce IDE project files for Microsoft Visual Studio +6, Borland CBuilderX and Apple Xcode to assist in debugging. + +Prerequisites: + +Apache Ant 1.6.1 or later (1.6.2 preferred) + http://ant.apache.org + +cpptasks.jar and ant-contrib.jar on CLASSPATH + (March 2005 or later releases or CVS HEAD) + http://ant-contrib.sourceforge.net + +JDK 1.4 or later. Earlier versions might work but +have not been tested. + +GNU patch on command path. + +GNU sed on command path (required for tests) + +Connection to internet + + - or - + +The following files placed in the lib directory: + apr-1.1.0.tar.gz + apr-util-1.1.0.tar.gz + apr-iconv-1.0.1.tar.gz + cppunit-1.10.2.gz + + http://apr.apache.org + http://cppunit.sourceforge.net + + + +Building: + +Unix gcc: + +$> export CLASSPATH=path_to_cpptasks/cpptasks.jar:path_to_antcontrib/ant-contrib.jar + +- or - + +$> setenv CLASSPATH path_to_cpptasks/cpptasks.jar:path_to_antcontrib/ant-contrib.jar + + +$> ant + + +Microsoft Visual C++: + +$> set CLASSPATH=path_to_cpptasks/cpptasks.jar;path_to_antcontrib/ant-contrib.jar +$> path_to_vc\bin\vcvars32 +$> ant + + +Borland C++: + +$> set CLASSPATH=path_to_cpptasks/cpptasks.jar;path_to_antcontrib/ant-contrib.jar +$> ant -Dcompiler=bcc + + + +Build options: + + -Dcompiler= see list from http://ant-contrib.sourceforge.net/cc.html + -Ddebug=[true | false] + -Dlibtype=[shared | static | dylib] + -Drtti=[false | true] + -Dapache.mirror=URL + -Dcppunit.mirror=URL + -Dapr.lib.type=[static | shared] + -Daprutil.lib.type=[static | shared] + -Dapriconv.lib.type=[static | shared] + +Build targets: + + build Build log4cxx library + build-all Builds all artifacts + build-examples Builds example programs + build-performance Builds performance test + build-projects-cbx Builds project files for Borland CBuilderX + build-projects-vc6 Builds project files for Microsoft Visual C++ 6 + build-projects-xcode Builds project files for Apple Xcode + build-shortsocketserver builds a socket server used by unit tests + build-standalone-unittest Builds a unit tests + log4cxx executable + build-unittest Builds unit test app + check Runs all diagnostic tests + clean Removes built files + dist Builds a source distribution + fixcrlf repair end-of-line sequences + header-check Checks headers against Effective C++ guidelines + run-standalone-unittest Runs standalone unit test + run-unittest Runs unit test + usage Describes usage of the build script + + + + + +autotools +================== + + autoconf.sh is known to be incompatible with some versions +of autotools. The autotools make has not been kept up to date +with development. See Bug LOGCXX-43 for details on this issue. +The following description has not been changed since log4cxx-0.9.7. + The `configure' shell script attempts to guess correct values for various system-dependent variables used during compilation. It uses those values to create a `Makefile' in each directory of the package. @@ -200,34 +309,3 @@ `configure' also accepts some other, not widely useful, options. -MsDev 6.0 Compilation -===================== - -If you want to compile a dynamic library (dll), compile msvc/dll/dll.dsp. -If you want to compile a static library (lib), compile msvc/static/static.dsp. - -The DOMConfigurator class is compiled with the MSXML library, if 'HAVE_XML' -and 'HAVE_MS_XML' are defined in the config_msvc.h file. - -The ODBCAppender class is compiled with the Microsoft ODBC library, if -'HAVE_ODBC' and 'HAVE_MS_ODBC' are defined in the config_msvc.h file. - -The SMTPAppender class is compiled with the Microsoft CDO library, if -'HAVE_SMTP' and 'HAVE_CDO_SMTP' are defined in the config_msvc.h file. -(not yet implemented) - -log4cxx is build with Windows native thread support, if 'HAVE_THREAD' and -'HAVE_MS_THREAD' are defined in the config_msvc.h file. - -UNICODE support is available through 'Unicode Debug' and 'Unicode Release' -compilation targets. - -Visual Studio .Net 2003 Compilation -=================================== - -If you want to compile a dynamic library (dll), compile msvc/dll/dll.vcproj. -If you want to compile a static library (lib), compile msvc/static/static.vcproj. - -The config_msvc.h file options are same as for MsDev 6.0 - -
