commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rdon...@apache.org
Subject cvs commit: jakarta-commons/betwixt/xdocs faq.xml
Date Mon, 30 Dec 2002 19:13:09 GMT
rdonkin     2002/12/30 11:13:09

  Modified:    betwixt/xdocs faq.xml
  Log:
  Added FAQ for digestor extra rules limitation. Also improved document structure
  
  Revision  Changes    Path
  1.3       +40 -6     jakarta-commons/betwixt/xdocs/faq.xml
  
  Index: faq.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/faq.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- faq.xml	12 Jun 2002 21:40:06 -0000	1.2
  +++ faq.xml	30 Dec 2002 19:13:09 -0000	1.3
  @@ -58,6 +58,14 @@
           </a>
         </li>
       </ol>
  +    <p><strong>Reading Beans</strong></p>
  +    <ol>
  +      <li>
  +        <a href="#digester-limitation">
  +          How can I make my extra digestion <em>Rule</em>s work with Betwixt?
  +        </a>
  +      </li>
  +    </ol>
       <p><strong>Building Betwixt</strong></p>
       <ol>
         <li>
  @@ -67,7 +75,7 @@
         </li>
       </ol>
   
  -    <section name="General">
  +    <subsection name="General">
         <dl>
           <dt>
             <a name="what-is-betwixt">
  @@ -120,8 +128,8 @@
   			to your own look and feel. Long term bean serialization doesn't generate nice looking
XML.
           </dd>
         </dl>
  -    </section>
  -    <section name="Writing Beans">     
  +    </subsection>
  +    <subsection name="Writing Beans">     
         <dl>
           <dt>
             <a name="output-options">
  @@ -183,8 +191,34 @@
           </dd>
         </dl>   
             
  -    </section>
  -    <section name="Building Betwixt">
  +    </subsection>
  +    <subsection name="Reading Beans">
  +      <dl>
  +        <dt>
  +          <a name="digester-limitation">
  +            How can I make my extra digestion <em>Rule</em>s work with Betwixt?
  +          </a>
  +        </dt>
  +        <dd>
  +            Betwixt uses <a href='http://jakarta.apache.org/commons/digester.html'>Digester</a>
for bean
  +            reading. The current implementation adds new <em>Rule</em>s at
run time (which handle 
  +            the reading of child elements). This makes life difficult for any extra <em>Rule</em>s

  +            added by the user before the digestion started.
  +        </dd>
  +        <dd>
  +            Extra <em>Rule</em>s added by the user will probably not work as
expected. It may 
  +            be possible to find ways to make them work - but equally well, it may be impossible.
  +        </dd>
  +        <dd>
  +            <em>This is a known limitation.</em>
  +        </dd>
  +        <dd>
  +            Hopefully, this will be addressed in a later release.
  +            Until then, you are recommended to use the mapping mechanisms in Betwixt instead.
  +        </dd>
  +      </dl>
  +    </subsection>
  +    <subsection name="Building Betwixt">
         <dl>
           <dt>
             <a name="how-to-build">
  @@ -198,7 +232,7 @@
             documentation for details.
           </dd>
         </dl>
  -    </section>
  +    </subsection>
     </section>
   </body>
   </document>
  
  
  

--
To unsubscribe, e-mail:   <mailto:commons-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:commons-dev-help@jakarta.apache.org>


Mime
View raw message