I've been working on moving the entire Logging Services project over
to Maven 2.0 for release building. For log4cxx, that primarily means
using Maven for web site generation and maintenance and having Maven
delegate to Ant to actually compile the project and miscellaneous
other tasks. I've done a first pass on log4cxx which only leaves
log4net non-Mavenized.
There is a staged copy of the new LS web site at http://
svn.apache.org/repos/asf/logging/site/trunk/docs/index.html. I
expect that we would push that out at the time log4j 1.2.15 is
released. There are a few known issues with the log4cxx content
there. The change report doesn't display details on releases prior
to 0.10.0 and the 0.10.0 issues were a quick snapshot of JIRA issues
and contains resolved and unresolved issues. The LS logo wasn't
displaying. The "Short introduction" and FAQ were copied from log4j
and need to be modified for log4cxx.
To build the site, install Maven 2.0.7 and doxygen and run "mvn site"
to generate the site or "mvn site-deploy" to generate the site and
commit to the SVN server. Deployment requires commit access to the
SVN and that your machine accepts SSH connections.
To make the process similar to the other LS projects and other
Mavenized builds, I've made wholesale moves of source files to fit
the Maven Standard Directory Layout (http://maven.apache.org/guides/
introduction/introduction-to-the-standard-directory-layout.html).
I've updated the Ant build.xml for the new layout, but the automake
build is expected to be broken by the changes. Would be very helpful
if a volunteer (Andreas?) could update the Makefile.am's for the new
layout. The essential new locations are (src/main/cpp for log4cxx
implementation, src/main/include for log4cxx includes, src/test/cpp
for unit tests, src/test/resources for test files, src/examples/cpp
for examples).
Maven can automatically download cpptasks, however the version
currently in the Maven repo doesn't seem to have the IDE project
generation elements. I expect to Mavenize cpptasks and create a new
release and then I'll update the project descriptor for the new
release of cpptasks.
I also removed the APR and APR-util download code and snapshotted
apr-1.2.9 and apr-util-1.2.8 into src/apr and src/apr-util
directories. cppunit is still downloaded and will likely review the
possibility of abstracting the tests so they could run on either
cppunit or APR's unit test framework.
