craigmcc 01/08/04 17:02:22 Modified: digester/src/java/org/apache/commons/digester package.html Log: More decoupling of Digester from its legacy of being part of Struts. Revision Changes Path 1.4 +10 -6 jakarta-commons/digester/src/java/org/apache/commons/digester/package.html Index: package.html =================================================================== RCS file: /home/cvs/jakarta-commons/digester/src/java/org/apache/commons/digester/package.html,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- package.html 2001/07/30 15:23:14 1.3 +++ package.html 2001/08/05 00:02:21 1.4 @@ -135,10 +135,11 @@ technology is to dynamically construct a tree of Java objects, whose internal organization, as well as the details of property settings on these objects, are configured based on the contents of the XML document. In fact, the -primary reason that the Digester package was created was to facilitate the -way that the Struts <a href="../action/ActionServlet.html">controller -servlet</a> configures itself based on the contents of your application's -<code>struts-config.xml</code> file.</p> +primary reason that the Digester package was created (it was originally part +of Struts, and then moved to the Commons project because it was recognized +as being generally useful) was to facilitate the +way that the Struts controller servlet configures itself based on the contents +of your application's <code>struts-config.xml</code> file.</p> <p>To facilitate this usage, the Digester exposes a stack that can be manipulated by processing rules that are fired when element matching patterns @@ -362,10 +363,10 @@ <a name="doc.Usage"></a> <h3>Usage Examples</h3> -<h5>Processing The Struts Configuration File</h5> +<h5>Processing A Struts Configuration File</h5> <p>As stated earlier, the primary reason that the -<code>org.apache.commons.digester.Digester</code> package exists is because the +<code>Digester</code> package was created is because the Struts controller servlet itself needed a robust, flexible, easy to extend mechanism for processing the contents of the <code>struts-config.xml</code> configuration that describes nearly every aspect of a Struts-based application. @@ -375,6 +376,9 @@ <code>org.apache.struts.action.ActionServlet</code> for the code that creates and configures the Digester to be used, and the <code>initMapping()</code> method for where the parsing actually takes place.</p> + +<p>(Struts binary and source distributions can be acquired at +<a href="http://jakarta.apache.org/struts/">http://jakarta.apache.org/struts/</a>.)</p> <p>The following discussion highlights a few of the matching patterns and processing rules that are configured, to illustrate the use of some of the