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 Curt Arnold <ca...@apache.org> on 2007/07/25 02:07:13 UTC

Maven generated website, APR & APR-util inline, automake broken

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.