You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by rd...@apache.org on 2004/02/15 10:38:22 UTC
cvs commit: jakarta-commons/digester/xdocs/images logo.png
rdonkin 2004/02/15 01:38:22
Modified: logging build.properties.sample project.xml
digester/xdocs index.xml navigation.xml
digester/xdocs/images logo.png
Log:
Added maven build (aimed at documentation). This isn't totally satisfactory (for example, I've stripped out the unit tests) and the user guide formatting isn't brilliant. But i feel that i want to be able to get some feedback and there are some other priorities. i'll try to get to this work later.
Revision Changes Path
1.8 +4 -0 jakarta-commons/logging/build.properties.sample
Index: build.properties.sample
===================================================================
RCS file: /home/cvs/jakarta-commons/logging/build.properties.sample,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- build.properties.sample 7 May 2003 16:02:20 -0000 1.7
+++ build.properties.sample 15 Feb 2004 09:38:22 -0000 1.8
@@ -13,3 +13,7 @@
#
# junit.jar=../../jakarta-velocity/build/lib/junit-3.7.jar
+# Maven properties (for web site build)
+# Those committers using agents may like to use
+#maven.username=rdonkin
+#logging.cvs=lserver:rdonkin@cvs.apache.org:/home/cvs
\ No newline at end of file
1.11 +90 -3 jakarta-commons/logging/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/logging/project.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- project.xml 10 Feb 2004 19:15:05 -0000 1.10
+++ project.xml 15 Feb 2004 09:38:22 -0000 1.11
@@ -4,17 +4,90 @@
<extend>../commons-build/project.xml</extend>
<name>Logging</name>
<id>commons-logging</id>
+ <logo></logo>
<currentVersion>1.0-dev</currentVersion>
+ <organization>
+ <name>Apache Software Foundation</name>
+ <url>http://www.apache.org</url>
+ <logo>http://jakarta.apache.org/images/jakarta-logo.gif</logo>
+ </organization>
+
<inceptionYear>2001</inceptionYear>
<shortDescription>Commons Logging</shortDescription>
<description>
- Commons Logging
+Commons Logging is a thin adapter allowing configurable bridging to other,
+well known logging systems.
</description>
+
+ <logo>/images/logo.png</logo>
+
+ <repository>
+ <connection>scm:cvs:${logging.cvs}:jakarta-commons/logging/</connection>
+ <url>http://cvs.apache.org/viewcvs/jakarta-commons/logging/</url>
+ </repository>
<url>http://jakarta.apache.org/commons/logging/</url>
<developers>
+ <developer>
+ <name>Morgan Delagrange</name>
+ <id>morgand</id>
+ <email>morgand at apache dot org</email>
+ <organization>Apache</organization>
+ <roles><role>Java Developer</role></roles>
+ </developer>
+ <developer>
+ <name>Rodney Waldhoff</name>
+ <id>rwaldhoff</id>
+ <email>rwaldhoff at apache org</email>
+ <organization>Apache Software Foundation</organization>
+ </developer>
+ <developer>
+ <name>Craig McClanahan</name>
+ <id>craigmcc</id>
+ <email>craigmcc at apache org</email>
+ <organization>Apache Software Foundation</organization>
+ </developer>
+ <developer>
+ <name>Scott Sanders</name>
+ <id>sanders</id>
+ <email>sanders at apache dot org</email>
+ <organization>Apache Software Foundation</organization>
+ </developer>
+ <developer>
+ <name>Robert Burrell Donkin</name>
+ <id>rdonkin</id>
+ <email>rdonkin at apache dot org</email>
+ <organization>Apache Software Foundation</organization>
+ </developer>
+ <developer>
+ <name>Peter Donald</name>
+ <id>donaldp</id>
+ <email>donaldp at apache dot org</email>
+ <organization></organization>
+ </developer>
+ <developer>
+ <name>Costin Manolache</name>
+ <id>costin</id>
+ <email>costin at apache dot org</email>
+ <organization>Apache Software Foundation</organization>
+ </developer>
+ <developer>
+ <name>Richard Sitze</name>
+ <id>rsitze</id>
+ <email>rsitze at apache dot org</email>
+ <organization>Apache Software Foundation</organization>
+ </developer>
+ <developer>
+ <name>Juozas Baliuka</name>
+ <id>baliuka</id>
+ <email>baliuka@apache.org</email>
+ <organization></organization>
+ <roles>
+ <role>Java Developer</role>
+ </roles>
+ </developer>
</developers>
<dependencies>
@@ -36,11 +109,10 @@
<dependency>
<id>avalon-framework</id>
- <version>4.0</version>
+ <version>4.1.3</version>
</dependency>
</dependencies>
-
<build>
<sourceModifications>
<sourceModification>
@@ -50,6 +122,21 @@
</excludes>
</sourceModification>
</sourceModifications>
+ <unitTest>
+ <!--
+At the moment there are problems running the unit tests under maven.
+the unit tests run by custom ant target which perform configuration
+before the tests are run.
+There is no easy way to run these under maven at the moment.
+ -->
+ <directory>${pom.build.unitTestSourceDirectory}</directory>
+ <includes>
+ <include>**/AvalonLoggerTest.java</include>
+ </includes>
+ <resources>
+ <resource>**/*.properties</resource>
+ </resources>
+ </unitTest>
</build>
</project>
1.5 +47 -62 jakarta-commons/digester/xdocs/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/digester/xdocs/index.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- index.xml 10 Aug 2003 18:56:11 -0000 1.4
+++ index.xml 15 Feb 2004 09:38:22 -0000 1.5
@@ -9,84 +9,69 @@
<body>
-<section name="The Digester Component">
-
-<p>Many Jakarta projects read XML configuration files to provide initialization
-of various Java objects within the system. There are several ways of doing
-this, and the <em>Digester</em> component was designed to provide a common
-implementation that can be used in many different projects.</p>
-
-<p>Basically, the <em>Digester</em> package lets you configure an XML ->
-Java object mapping module, which triggers certain actions called
-<em>rules</em> whenever a particular pattern of nested XML elements is
-recognized. A rich set of predefined <em>rules</em> is available for your
-use, or you can also create your own. Advanced features of <em>Digester</em>
-include:</p>
-<ul>
-<li>Ability to plug in your own pattern matching engine, if the standard one
- is not sufficient for your requirements.</li>
-<li>Optional namespace-aware processing, so that you can define rules that
- are relevant only to a particular XML namespace.</li>
-<li>Encapsulation of <em>Rules</em> into <em>RuleSets</em> that can be
- easily and conveniently reused in more than one application that requires
- the same type of processing.</li>
-</ul>
+<section name="The Logging Component">
+<p>There is a great need for debugging and logging information inside of
+Commons components such as HTTPClient and DBCP. However, there are many
+logging APIs out there and it is difficult to choose among them.</p>
+
+<p>The Logging package is an ultra-thin bridge between different logging
+libraries. Commons components may use the Logging API to remove
+compile-time and run-time dependencies on any particular logging package,
+and contributors may write Log implementations for the library of
+their choice.</p>
</section>
<section name="Documentation">
-<p>The <a href="http://jakarta.apache.org/commons/digester/RELEASE-NOTES.txt">
+<p>The <a href="http://jakarta.apache.org/commons/logging/RELEASE-NOTES.txt">
Release Notes</a> document the new features and bug fixes that have been
-included in this release.</p>
+included in the latest release.</p>
-<p>The <a href="http://jakarta.apache.org/commons/digester/api/index.html">
-JavaDoc API documents</a> are available online. In particular, you should
-read the package description for the <code>org.apache.commons.digester</code>
-package for detailed information on using the package.</p>
+<p>The <a href="http://jakarta.apache.org/commons/logging/api/index.html">
+JavaDoc API documents</a> for the latest release are available online.
+In particular, you should read the package overview of the <code>org.apache.commons.logging</code>
+package. In addition, there is a (short)
+<a href="guide.html">User Guide</a>.</p>
</section>
<section name="Releases">
- <ul>
- <li>Version 1.5 (from mirror) - 27 Apr 2003
- <a href="http://jakarta.apache.org/site/binindex.cgi">binary</a>
- <a href="http://jakarta.apache.org/site/sourceindex.cgi">source</a> (latest)</li>
- <li>Version 1.4.1 (from mirror)
- <a href="http://jakarta.apache.org/site/binindex.cgi">binary</a>
- <a href="http://jakarta.apache.org/site/sourceindex.cgi">source</a></li>
- <li>Version 1.4 (from mirror)
- <a href="http://jakarta.apache.org/site/binindex.cgi">binary</a>
- <a href="http://jakarta.apache.org/site/sourceindex.cgi">source</a>
- </li>
- <li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-digester/v1.3/">Version 1.3</a></li>
- <li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-digester/v1.2/">Version 1.2</a></li>
- <li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-digester/v1.1.1/">Version 1.1.1</a></li>
- <li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-digester/v1.0/">Version 1.0</a></li>
- </ul>
+ <subsection name='Mirrored Releases'>
+<p>
+Releases after 1.0.2 should be downloaded from a mirror. Please remember to verify the
+sigature of the release from the
+<a href='http://www.apache.org/dist/jakarta/commons/logging/'>main apache site</a>
+when downloading from a mirror.
+</p>
+<p>
+ Binary releases are available
+ <a href="http://jakarta.apache.org/site/binindex.cgi">here</a>.
+ Source releases are available
+ <a href="http://jakarta.apache.org/site/sourceindex.cgi">here</a>
+</p>
+<p>
+<ul>
+ <li>Version 1.0.3 (latest) - 7 Apr 2003</li>
+</ul>
+</p>
+ </subsection>
+ <subsection name='Older Releases (Not Mirrored)'>
+ <p>
+ <ul>
+<ul>
+<li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-logging/v1.0.2/">Version 1.0.2</a></li>
+<li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-logging/v1.0.1/">Version 1.0.1</a></li>
+<li><a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-logging/v1.0/">Version 1.0</a></li>
+</ul>
+ </ul>
+ </p>
+ </subsection>
</section>
-<section name="Resources">
- <ul>
- <!-- newest first sounds like a reasonable rule -->
- <li>
- Jun 2, 2003 - <a href="http://www-106.ibm.com/developerworks/java/library/j-lucene/">IBM developerWorks article</a> by Otis Gospodnetic about parsing, indexing and searching XML with Digester and Lucene.
- </li>
- <li>
- Oct 25, 2002 - <a href="http://www.javaworld.com">JavaWorld</a> has an
- article on Digester entitled <a href="http://www.javaworld.com/javaworld/jw-10-2002/jw-1025-opensourceprofile.html">
- Simplify XML file processing with the Jakarta Commons Digester</a>.
- </li>
- <li>
- Oct 23, 2002 - <a href="http://www.onjava.com">OnJava</a> has an article
- on Digester entitled
- <a href="http://www.onjava.com/pub/a/onjava/2002/10/23/digester.html">
- Learning and using Jakarta Digester</a>.</li>
- </ul>
-</section>
</body>
</document>
1.7 +6 -6 jakarta-commons/digester/xdocs/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/digester/xdocs/navigation.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- navigation.xml 14 Jan 2004 04:10:21 -0000 1.6
+++ navigation.xml 15 Feb 2004 09:38:22 -0000 1.7
@@ -4,10 +4,10 @@
<!ENTITY commons-nav SYSTEM "../../incl_nav.xml">
]>
-<project name="Digester">
+<project name="Logging">
- <title>Digester</title>
- <organizationLogo href="/images/jakarta-logo-blue.gif">
+ <title>Logging</title>
+ <organizationLogo href="/images/jakarta-logo.gif">
Jakarta
</organizationLogo>
@@ -17,11 +17,11 @@
href="http://jakarta.apache.org/commons/"/>
</links>
- <menu name="Commons Digester">
+ <menu name="Commons Logging">
<item name="Overview"
href="/index.html"/>
- <item name="Guide (Current)"
- href="/apidocs/org/apache/commons/digester/package-summary.html"/>
+ <item name="User Guide"
+ href="/guide.html"/>
</menu>
&commons-nav;
1.2 +40 -48 jakarta-commons/digester/xdocs/images/logo.png
<<Binary file>>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org