cvs commit: jakarta-commons/digester/src/java/org/apache/commons/digester package.html

[rd...@apache.org]

rdonkin     2003/09/28 02:41:29

  Modified:    digester build.xml
               digester/src/java/org/apache/commons/digester package.html
  Log:
  Added build for the examples. Submitted by Simon Kitching.
  
  Revision  Changes    Path
  1.46      +7 -1      jakarta-commons/digester/build.xml
  
  Index: build.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/digester/build.xml,v
  retrieving revision 1.45
  retrieving revision 1.46
  diff -u -r1.45 -r1.46
  --- build.xml	28 Apr 2003 17:51:31 -0000	1.45
  +++ build.xml	28 Sep 2003 09:41:29 -0000	1.46
  @@ -190,6 +190,12 @@
     </target>
   
   
  +  <target name="compile.examples" depends="compile"
  +   description="Compile example code">
  +    <ant dir="src/examples/api" target="compile"/>
  +  </target>
  +
  +
     <target name="clean"
      description="Clean build and distribution directories">
       <delete    dir="${build.home}"/>
  
  
  
  1.23      +18 -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.22
  retrieving revision 1.23
  diff -u -r1.22 -r1.23
  --- package.html	30 Aug 2003 18:31:52 -0000	1.22
  +++ package.html	28 Sep 2003 09:41:29 -0000	1.23
  @@ -85,6 +85,9 @@
       the processing rules.</li>
   </ul>
   
  +<p>For example code, see <a href="#doc.Usage"> the usage 
  +examples</a>, and <a href="#doc.FAQ.Examples"> the FAQ </a>. </p>
  +
   <a name="doc.Properties"></a>
   <h3>Digester Configuration Properties</h3>
   
  @@ -815,6 +818,11 @@
   Rule Sets</a> if you wish to reuse a particular set of rules, associated
   with a particular namespace, in more than one application context.</p>
   
  +<p>Note that Digester does not provide general "xpath-compliant" matching;
  +only the namespace attached to the <i>last</i> element in the match path
  +is involved in the matching process. Namespaces attached to parent
  +elements are ignored for matching purposes.</p>
  +
   <h4>Using Namespace Prefixes In Pattern Matching</h4>
   
   <p>Using rules with namespaces is very useful when you have orthogonal rulesets. 
  @@ -995,13 +1003,17 @@
   </pre></code>
   This property is needed for JAXP 1.2 (XML Schema support) as required
   for the Servlet Spec. 2.4 but is not recognized by JAXP 1.1 parsers.
  -This warning is harmless.
  -</p></li>
  -<li><strong>Where Can I Find Example Code?</strong>
  +This warning is harmless.</p>
   <p>
  -Digester ships with a sample application: a mapping for the <em>Rich Site Summary</em> format used
  -by many newsfeeds. Download the source distribution to see how it works. 
  -</p>
  +</li>
  +<li></a><strong>Where Can I Find Example Code?</strong>
  +<a name="doc.FAQ.Examples">
  +<p>Digester ships with a sample application: a mapping for the <em>Rich Site 
  +Summary</em> format used by many newsfeeds. Download the source distribution 
  +to see how it works.</p>
  +<p>Digester also ships with a set of examples demonstrating most of the 
  +features described in this document. See the "src/examples" subdirectory 
  +of the source distribution.</p>
   </li>
   <li><strong>When Are You Going To Support <em>Rich Site Summary</em> Version x.y.z?</strong>
   <p>