You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by hu...@apache.org on 2002/06/29 05:21:02 UTC

cvs commit: jakarta-struts/doc/userGuide dev_validator.xml dev_utils.xml dev_template.xml dev_nested.xml dev_logic.xml dev_html.xml dev_bean.xml project.xml preface.xml index.xml dev_tiles.xml building_view.xml building_controller.xml

husted      2002/06/28 20:21:02

  Modified:    doc/userGuide project.xml preface.xml index.xml
                        dev_tiles.xml building_view.xml
                        building_controller.xml
  Added:       doc/userGuide dev_validator.xml dev_utils.xml
                        dev_template.xml dev_nested.xml dev_logic.xml
                        dev_html.xml dev_bean.xml
  Log:
  Add "TODO" markers where 1.1 documentation can be added.
  Add a Developers Guide portal page to link to package description,
  API, and any other resources.
  
  Revision  Changes    Path
  1.12      +10 -21    jakarta-struts/doc/userGuide/project.xml
  
  Index: project.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/userGuide/project.xml,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -r1.11 -r1.12
  --- project.xml	28 Jun 2002 22:22:07 -0000	1.11
  +++ project.xml	29 Jun 2002 03:21:02 -0000	1.12
  @@ -16,32 +16,21 @@
   
       <menu name="Developer Guides">
           <item name="Bean Tags"
  -              href="../api/org/apache/struts/taglib/bean/package-summary.html#package_description"/>
  +              href="dev_bean.html"/>
           <item name="HTML Tags"
  -              href="../api/org/apache/struts/taglib/html/package-summary.html#package_description"/>
  +              href="dev_html.html"/>
           <item name="Logic Tags"
  -              href="../api/org/apache/struts/taglib/logic/package-summary.html#package_description"/>
  +              href="dev_logic.html"/>
           <item name="Nested Tags"
  -              href="../api/org/apache/struts/taglib/nested/package-summary.html#package_description"/>
  +              href="dev_nested.html"/>
           <item name="Template Tags"
  -              href="../api/org/apache/struts/taglib/template/package-summary.html#package_description"/>
  -        <item name="Utilities"
  -              href="../api/org/apache/struts/util/package-summary.html#package_description"/>
  -    </menu>
  -
  -    <menu name="TagLib Documentation">
  -        <item name="Bean Tags"
  -              href="struts-bean.html"/>
  -        <item name="HTML Tags"
  -              href="struts-html.html"/>
  -        <item name="Logic Tags"
  -              href="struts-logic.html"/>
  -        <item name="Nested Tags"
  -              href="struts-nested.html"/>
  -        <item name="Template Tags"
  -              href="struts-template.html"/>
  +              href="dev_template.html"/>
           <item name="Tiles Tags"
  -              href="struts-tiles.html"/>
  +              href="dev_tiles.html"/>
  +        <item name="Utilities"
  +              href="dev_utils.html"/>
  +        <item name="Validator"
  +              href="dev_validator.html"/>
       </menu>
   
       <menu name="Getting Started">
  
  
  
  1.2       +2 -4      jakarta-struts/doc/userGuide/preface.xml
  
  Index: preface.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/userGuide/preface.xml,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- preface.xml	28 Jun 2002 20:59:59 -0000	1.1
  +++ preface.xml	29 Jun 2002 03:21:02 -0000	1.2
  @@ -144,7 +144,7 @@
       <p>Java applications, including web applications, are often configured using 
       <a href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/Properties.html">Properties</a> 
       files. Properties files are the basis for the 
  -    <a href="resourcebundle">ResourceBundles</a> that Struts uses to provide messages resources 
  +    <a href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/ResourceBundle.html">ResourceBundles</a> that Struts uses to provide messages resources 
       to an application. </p>
   
       <p>For more about Properties files, see: </p>
  @@ -154,9 +154,7 @@
       <b>Using Properties to Manage Program Attributes</b></a> in The Java Tutorial</li>
       </ul>
   
  -    <p>Java 
  -    <a href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/ResourceBundle.html">ResourceBundles</a> 
  -    use one or more Properties files to provide internationalized messages 
  +    <p>Java ResourceBundles use one or more Properties files to provide internationalized messages 
       to users based their 
       <a href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/Locale.html">Locale</a>. 
       Support for localizing an application was built into Struts from the ground-up.</p>
  
  
  
  1.9       +3 -2      jakarta-struts/doc/userGuide/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/userGuide/index.xml,v
  retrieving revision 1.8
  retrieving revision 1.9
  diff -u -r1.8 -r1.9
  --- index.xml	28 Jun 2002 20:59:59 -0000	1.8
  +++ index.xml	29 Jun 2002 03:21:02 -0000	1.9
  @@ -62,8 +62,9 @@
                       <ul>
                       <li><a href="building_view.html#custom_tags">3.4.1 Application-Specific Custom Tags</a></li>
                       <li><a href="building_view.html#includes">3.4.2 Page Composition With Includes</a></li>
  -                    <li><a href="building_view.html#image_rendering">3.4.3 Image Rendering Components</a></li>
  -                    <li><a href="building_view.html#text_rendering">3.4.4 Rendering Text</a></li>
  +                    <li><a href="building_view.html#includes">3.4.3 Page Composition With Tiles</a></li>
  +                    <li><a href="building_view.html#image_rendering">3.4.4 Image Rendering Components</a></li>
  +                    <li><a href="building_view.html#text_rendering">3.4.5 Rendering Text</a></li>
                       </ul></li>
                   </ul></li>
               <li><a href="building_controller.html">4. Building Controller Components</a>
  
  
  
  1.3       +2 -2      jakarta-struts/doc/userGuide/dev_tiles.xml
  
  Index: dev_tiles.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/userGuide/dev_tiles.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- dev_tiles.xml	28 Jun 2002 20:59:59 -0000	1.2
  +++ dev_tiles.xml	29 Jun 2002 03:21:02 -0000	1.3
  @@ -3,10 +3,10 @@
   <properties>
   <author>Ted Husted</author> 
   <author>Cedric Dumoulin</author> 
  -<title>The Struts User's Guide - Validating user input</title>
  +<title>The Struts User's Guide - Tiles Guide</title>
   </properties>
   <body> 
  -<chapter name="Tiles Developer Guide"> 
  +<chapter name="Tiles Guide"> 
   
   <section href="tiles" name="The Tiles Document Assembly Framework">
   
  
  
  
  1.13      +30 -25    jakarta-struts/doc/userGuide/building_view.xml
  
  Index: building_view.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/userGuide/building_view.xml,v
  retrieving revision 1.12
  retrieving revision 1.13
  diff -u -r1.12 -r1.13
  --- building_view.xml	24 Jun 2002 11:14:44 -0000	1.12
  +++ building_view.xml	29 Jun 2002 03:21:02 -0000	1.13
  @@ -49,23 +49,26 @@
         </p>
         
         <ul>
  -        <li><b>Locale</b> - The fundamental Java class that supports
  -            internationalization is <code>java.util.Locale</code>.  Each
  +        <li><a href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/Locale.html"><b>Locale</b></a> - 
  +            The fundamental Java class that supports
  +            internationalization is <code>Locale</code>.  Each
               <code>Locale</code> represents a particular choice of country and
               language (plus an optional language variant), and also a set of
               formatting assumptions for things like numbers and dates.</li>
  -        <li><b>ResourceBundle</b> - The <code>java.util.ResourceBundle</code> class
  +        <li><a href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/ResourceBundle.html"><b>ResourceBundle</b></a> - 
  +            The <code>java.util.ResourceBundle</code> class
               provides the fundamental tools for supporting messages in multiple
               languages.  See the Javadocs for the <code>ResourceBundle</code> class,
               and the information on Internationalization in the documentation bundle
               for your JDK release, for more information.</li>
  -        <li><b>PropertyResourceBundle</b> - One of the standard implementations of
  +        <li><a href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/PropertyResourceBundle.html"><b>PropertyResourceBundle</b></a> - 
  +            One of the standard implementations of
               <code>ResourceBundle</code> allows you to define resources using the
               same "name=value" syntax used to initialize properties files.  This is
               very convenient for preparing resource bundles with messages that are
               used in a web application, because these messages are generally text
               oriented.</li>
  -        <li><b>MessageFormat</b> - The <code>java.text.MessageFormat</code> class
  +        <li><a href="http://java.sun.com/j2se/1.4.1/docs/api/java/text/MessageFormat.html"><b>MessageFormat</b></a> - The <code>java.text.MessageFormat</code> class
               allows you to replace portions of a message string (in this case,
               one retrieved from a resource bundle) with arguments specified at
               run time.  This is useful in cases where you are creating a sentence,
  @@ -73,8 +76,8 @@
               The placeholder string <code>{0}</code> in the message is replaced by
               the first runtime argument, <code>{1}</code> is replaced by the second
               argument, and so on.</li>
  -        <li><b>MessageResources</b> - The Struts class
  -            <code><a href="api/org/apache/struts/util/MessageResources.html">org.apache.struts.util.MessageResources</a></code> lets you treat
  +        <li><a href="api/org/apache/struts/util/MessageResources.html"><b>MessageResources</b></a> - 
  +            The Struts class <code>org.apache.struts.util.MessageResources</code> lets you treat
               a set of resource bundles like a database, and allows you to request
               a particular message string for a particular Locale (normally one
               associated with the current user) instead of for the default Locale
  @@ -111,8 +114,9 @@
               might have an entry like this:
               <code>prompt.hello=Hello</code></li>
           <li><b>MyResources_xx.properties</b> - Contains the same messages in the
  -            language whose ISO language code is "xx" (See the ResourceBundle
  -            Javadoc page for a link to the current list).  For a French version
  +            language whose ISO language code is "xx" (See the 
  +            <a href="http://java.sun.com/j2se/1.4.1/docs/api/java/util/ResourceBundle.html">ResourceBundle Javadoc</a> 
  +            page for a link to the current list).  For a French version
               of the message shown above, you would have this entry:
               <code>prompt.hello=Bonjour</code>
               You can have resource bundle files for as many languages as you need.</li>
  @@ -163,7 +167,7 @@
         <blockquote> 
           <b>Note:</b> While the examples given here use JSP and custom tags, 
           the ActionForm beans and the other Struts controller components are 
  -        View neutral. Struts can be used with Velocity Templates, XLST, and 
  +        View neutral. Struts can be used with Velocity Templates, XSL, and 
           any other presentation technology that can be rendered via a Java 
           servlet. See the 
           <a href="../resources/index.html">
  @@ -317,7 +321,8 @@
                 It also associates all of the fields within this form with a session
                 scoped FormBean that is stored under the key <code>logonForm</code>.
                 The Struts developer provides the Java implementation of this form
  -              bean, subclassing the Struts class <code>ActionForm</code>.
  +              bean, subclassing the Struts class <code>ActionForm</code>
  +              (see <a href="building_controller">Building Controller</a> components).
                 This bean is used to provide initial values for all of the input
                 fields that have names matching the property names of the bean.
                 If an appropriate bean is not found, a new one will be created
  @@ -394,9 +399,11 @@
   </pre>
   <hr/>        
           <p>
  -          Look at the <a href="../api/index.html">Javadocs</a> for FormFile to see the
  -          methods it exposes to manipulate files in file uploading.  Also look at the
  -          Javadocs for ActionServlet and ActionMapping for the various parameters
  +          Look at the Javadocs for <code><a href="../api/org/apache/struts/upload/FormFile.html">FormFile</a></code> 
  +          to see the methods it exposes to manipulate files in file uploading.  
  +          Also look at the Javadocs for 
  +          <a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionServlet.html">ActionServlet</a> and 
  +          <a href="http://jakarta.apache.org/struts/api/org/apache/struts/action/ActionMapping.html">ActionMapping</a> for the various parameters
             you can specify to change how files are uploaded.  Basically in your
             <code>execute</code> method in your action class you would call <code>((UploadForm) form).getMyFile()</code>
             to retrieve the FormFile and do what you want with it.
  @@ -539,7 +546,7 @@
           <p>
             Beyond using the custom tags provided by the Struts library, it is easy
             to create tags that are specific to the application you are building, to
  -          assist in creating the user interface.  The example application included with
  +          assist in creating the user interface.  The MailRead example application included with
             Struts illustrates this principle by creating the following tags unique to
             the implementation of this application:
           </p>
  @@ -616,19 +623,17 @@
                or the "id" argument, which represents a page context String variable to print
                out to the jsp page.</li>
           </ul>
  +
  +      </section>
  +
  +      <section name="3.4.3 Page Composition With Tiles" href="Tiles">
  +
           <p>
  -          Another approach to this would be to use the Struts Template Tag library. See the         
  -          Developer's Guide for details. 
  -        </p>  
  -        <p>
  -          Tiles is an alternative to the original Template Tag library, offering several 
  -          enhancements and new capabilities. Tiles is bundled with Struts 1.1 and also 
  -          available from <a href="http://www.lifl.fr/~dumoulin/tiles/">
  -          Cedric Dumoulin's Web site</a>.
  +            [:TODO:]
           </p>
         </section>
   
  -      <section name="3.4.3 Image Rendering Components" href="image_rendering">
  +      <section name="3.4.4 Image Rendering Components" href="image_rendering">
         
           <p>
             Some applications require dynamically generated images, like the price
  @@ -650,7 +655,7 @@
           </ul>
         </section>
   
  -      <section name="3.4.4 Rendering Text" href="text_rendering">
  +      <section name="3.4.5 Rendering Text" href="text_rendering">
   
            <p>
              Some applications require dynamically generated text or markup, 
  
  
  
  1.18      +57 -14    jakarta-struts/doc/userGuide/building_controller.xml
  
  Index: building_controller.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/doc/userGuide/building_controller.xml,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- building_controller.xml	28 Jun 2002 20:59:59 -0000	1.17
  +++ building_controller.xml	29 Jun 2002 03:21:02 -0000	1.18
  @@ -38,7 +38,19 @@
         </ul>
       </section>
       
  -    <section name="4.2 Action Classes" href="action_classes">
  +    <section name="4.2 ActionForm Classes" href="action_form_classes">
  +    <p>[:TODO:]</p>
  +    </section>
  +
  +    <section name="4.2.1 DynaActionForm Classes" href="dyna_action_form_classes">
  +    <p>[:TODO:]</p>
  +    </section>
  +
  +    <section name="4.2.3 Map-backed ActionForms" href="map_action_form_classes">
  +    <p>[:TODO:]</p>
  +    </section>
  +
  +    <section name="4.3 Action Classes" href="action_classes">
         
         <p>The <code>Action</code> class defines two methods that could be
           executed depending on your servlet environment:
  @@ -169,7 +181,15 @@
       </p>
       </section>
           
  -    <section name="4.3 The ActionMapping Implementation" href="actionmapping">
  +    <section name="4.4 The ActionServlet" href="action_servlet">
  +    <p>[:TODO:]</p>
  +    </section>
  +
  +    <section name="4.4.x Exception Handler" href="exception_handler">
  +    <p>[:TODO:]</p>
  +    </section>
  +
  +    <section name="4.5 The ActionMapping Implementation" href="actionmapping">
         
         <p>
           In order to operate successfully, the Struts controller servlet needs
  @@ -201,7 +221,7 @@
                  
       </section>
       
  -    <section name="4.4 The Struts Configuration File" href="config">
  +    <section name="4.6 The Struts Configuration File" href="config">
         
         <p>
           How does the controller servlet learn about the mappings you want?  It
  @@ -223,7 +243,7 @@
         </p>
         
         <p>
  -        Inside of the &lt;struts-config&gt; element, there are two important
  +        Inside of the &lt;struts-config&gt; element, there are three important
           elements that are used to describe your actions:
           
           <blockquote>
  @@ -244,6 +264,9 @@
               </ul>
           </blockquote>
           <blockquote>
  +            [:TODO: ActionForwards]
  +        </blockquote>
  +        <blockquote>
             <b>&lt;action-mappings&gt;</b><br />
               This section contains your action definitions.  You use an &lt;action&gt; element
               for each of the mappings you would like to define.  Most action elements will 
  @@ -263,7 +286,10 @@
             </blockquote>
           
         </p>
  -        
  +
  +      </section>
  +
  +      <section name="4.6.1 ActionMapping Example" href="action_mapping_example">       
   
         <p>
           The <code>struts-config.xml</code> file from the example application includes
  @@ -342,8 +368,16 @@
           whatever local forward properties makes sense for your own application.
         </p>
           
  +      </section>
  +      <section name="4.6.2 Other Configuration Objects" href="other_config">
  +
         <p>
  -        One more section of good use is the <code>&lt;data-sources></code> section, which 
  +        Besides the objects related to defining ActionMappings, the Struts configuration may 
  +        contain elements that create other useful objects.
  +      </p>
  +
  +      <p>
  +        The <code>&lt;data-sources></code> section, which 
           specifies data sources that your application can use.This is how you would specify a basic data source for your application inside
           of struts-config.xml:
         </p>
  @@ -377,9 +411,14 @@
           For information on how to retrieve the data source, see the 
           <a href="building_model.html#databases">Accessing Relational Databases</a> section.  
         </p>
  +
  +      <p>
  +        [:TODO: MessageResources, Controller, PlugIn ]
  +      </p>
  +
       </section>
  -    
  -    <section name="4.5 The Web Application Deployment Descriptor" href="dd_config">
  +
  +    <section name="4.7 The Web Application Deployment Descriptor" href="dd_config">
         
         <p>
           The final step in setting up the application is to configure the application
  @@ -388,8 +427,9 @@
           for the example application as a guide, we see that the following entries need
           to be created or modified.
         </p>
  -      
  -      <section name="4.5.1 Configure the Action Servlet Instance" href="dd_config_servlet">
  +
  +      </section>
  +      <section name="4.7.1 Configure the Action Servlet Instance" href="dd_config_servlet">
           
           <p>
             Add an entry defining the action servlet itself, along with the appropriate
  @@ -435,6 +475,9 @@
             describe the default values that are assumed if you do not provide a value for 
             that initialization parameter.
           </p>
  +        <p>
  +           [:TODO: Conform with JavaDoc as to nominal and deprecated params]
  +        </p>
           <ul>
     
             <li><strong>application</strong> - Java class name of the application
  @@ -511,7 +554,7 @@
           </ul>
         </section>
         
  -      <section name="4.5.2 Configure the Action Servlet Mapping" href="dd_config_mapping">
  +      <section name="4.7.2 Configure the Action Servlet Mapping" href="dd_config_mapping">
         
           <p>
             <strong>Note:</strong> The material in this section is not specific to
  @@ -588,7 +631,7 @@
   
         </section>
         
  -      <section name="4.5.3 Configure the Struts Tag Library" href="dd_config_taglib">
  +      <section name="4.7.3 Configure the Struts Tag Library" href="dd_config_taglib">
           
           <p>
             Next, you must add an entry defining the Struts tag library.  There are currently four
  @@ -661,7 +704,7 @@
           </p>
         </section>
         
  -      <section name="4.5.4 Add Struts Components To Your Application" href="config_add">
  +      <section name="4.7.4 Add Struts Components To Your Application" href="config_add">
           
           <p>
            To use Struts, you must copy the .tld files that you require into
  @@ -674,7 +717,7 @@
         Next: <a href="release-notes.html">Release Notes</a>
         </p>
         </section>
  -    </section>
  +
     </chapter>
     </body>
   </document>
  
  
  
  1.1                  jakarta-struts/doc/userGuide/dev_validator.xml
  
  Index: dev_validator.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <document url="./resources.xml">
  <properties>
  <author>Ted Husted</author> 
  <author>David Winterfeldt</author> 
  <title>The Struts User's Guide - Validator Developer Guide</title>
  </properties>
  <body> 
  <chapter name="Struts Validator Developer Guide"> 
  
  <section href="validator" name="Struts Validator">
  <p>
  [:TODO:]
  </p>
  
  </section>
  
  <section href="resources" name="Validator Resources">
  
  <p><b><u>Validating Input</u></b> by David Winterfeldt and Ted Husted. 
  Sample chapter from <u>Java Web Development with Struts</u>; available as a 
  <u>free download</u> (PDF).
  </p>
  
  </section>
  
  </chapter></body></document>
  
  
  
  1.1                  jakarta-struts/doc/userGuide/dev_utils.xml
  
  Index: dev_utils.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <document url="./resources.xml">
  <properties>
  <author>Ted Husted</author> 
  <title>The Struts User's Guide - Utilities Guide</title>
  </properties>
  <body> 
  <chapter name="Utilities Guide"> 
  
  <section href="utils" name="The Utilities Package">
  
  <p>
  The Utilities package provides a variety of families of classes, to solve problems that are commonly 
  encountered in building web applications.  
  </p>
  
  </section>
  
  <section href="resources" name="Utilities Resources">
  
  <ul>
  <li><a href="../api/org/apache/struts/utils/package-summary.html#package_description">Utilities Package Description</a></li>
  </ul>
  </section>
  
  </chapter></body></document>
  
  
  
  1.1                  jakarta-struts/doc/userGuide/dev_template.xml
  
  Index: dev_template.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <document url="./resources.xml">
  <properties>
  <author>Ted Husted</author> 
  <title>The Struts User's Guide - Template Taglib Guide</title>
  </properties>
  <body> 
  <chapter name="Template Taglib Guide"> 
  
  <section href="nested" name="The Template Taglib">
  
  <p>
  The "struts-template" tag library contains tags that are useful in creating dynamic JSP templates for pages 
  which share a common format. These templates are best used when it is likely that a layout shared by several 
  pages in your application will change. The functionality provided by these tags is similar to what can be 
  achieved using standard JSP include directive, but are dynamic rather than static. 
  </p>
  
  </section>
  
  <section href="resources" name="Template Taglib Resources">
  
  <ul>
  <li><a href="../api/org/apache/struts/taglib/template/package-summary.html#package_description">Template Taglib Package Description</a></li>
  <li><a href="struts-template.html">Template Taglib API Reference</a></li>
  </ul>
  </section>
  
  </chapter></body></document>
  
  
  
  1.1                  jakarta-struts/doc/userGuide/dev_nested.xml
  
  Index: dev_nested.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <document url="./resources.xml">
  <properties>
  <author>Ted Husted</author> 
  <title>The Struts User's Guide - Nested Taglib Guide</title>
  </properties>
  <body> 
  <chapter name="Nested Taglib Guide"> 
  
  <section href="nested" name="The Nested Taglib">
  
  <p>
  Nested tags &amp; supporting classes extend the base struts tags to allow them to relate to each other in a nested nature. 
  The fundamental logic of the original tags don't change, except in that all references to beans and bean properties 
  will be managed in a nested context. 
  </p>
  
  </section>
  
  <section href="resources" name="Nested Taglib Resources">
  
  <ul>
  <li><a href="../api/org/apache/struts/taglib/nested/package-summary.html#package_description">Nested Taglib Package Description</a></li>
  <li><a href="struts-nested.html">Nested Taglib API Reference</a></li>
  </ul>
  </section>
  
  </chapter></body></document>
  
  
  
  1.1                  jakarta-struts/doc/userGuide/dev_logic.xml
  
  Index: dev_logic.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <document url="./resources.xml">
  <properties>
  <author>Ted Husted</author> 
  <title>The Struts User's Guide - Logic Taglib Guide</title>
  </properties>
  <body> 
  <chapter name="Logic Taglib Guide"> 
  
  <section href="html" name="The Logic Taglib">
  
  <p>
  The "struts-logic" tag library contains tags that are useful in managing conditional generation of output text, looping over object collections for repetitive generation of
  output text, and application flow management
  </p>
  
  </section>
  
  <section href="resources" name="Logic Tag Resources">
  
  <ul>
  <li><a href="../api/org/apache/struts/taglib/logic/package-summary.html#package_description">Logic Taglib Package Description</a></li>
  <li><a href="struts-logic.html">Logic Taglib API Reference</a></li>
  </ul>
  </section>
  
  </chapter></body></document>
  
  
  
  1.1                  jakarta-struts/doc/userGuide/dev_html.xml
  
  Index: dev_html.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <document url="./resources.xml">
  <properties>
  <author>Ted Husted</author> 
  <title>The Struts User's Guide - HTML Taglib Guide</title>
  </properties>
  <body> 
  <chapter name="HTML Taglib Guide"> 
  
  <section href="html" name="The HTML Taglib">
  
  <p>
  The tags in the Struts HTML library form a bridge between a JSP view and the other components of a Web application. 
  Since a dynamic Web application often depends on gathering data from a user, input forms play an important role in 
  the Struts framework. Consequently, the majority of the HTML tags involve HTML forms.
  </p>
  
  <p>
  The HTML taglib contains tags used to create Struts input forms, as well as other tags generally useful
  in the creation of HTML-based user interfaces.
  </p>
  </section>
  
  <section href="resources" name="HTML Tag Resources">
  
  <ul>
  <li><a href="../api/org/apache/struts/taglib/html/package-summary.html#package_description">HTML Taglib Package Description</a></li>
  <li><a href="struts-html.html">HTML Taglib API Reference</a></li>
  </ul>
  </section>
  
  </chapter></body></document>
  
  
  
  1.1                  jakarta-struts/doc/userGuide/dev_bean.xml
  
  Index: dev_bean.xml
  ===================================================================
  <?xml version="1.0" encoding="ISO-8859-1"?>
  <document url="./resources.xml">
  <properties>
  <author>Ted Husted</author> 
  <author>Cedric Dumoulin</author> 
  <title>The Struts User's Guide - Bean Taglib Guide</title>
  </properties>
  <body> 
  <chapter name="Bean Taglib Guide"> 
  
  <section href="bean" name="The Bean Taglib">
  
  <p>
  The "struts-bean" tag library contains JSP custom tags useful in defining new beans (in any desired scope) from a variety of possible sources, as well as a tag to
  render a particular bean (or bean property) to the output response. 
  </p>
  
  <p>
  This tag library contains tags useful in accessing beans and their properties, as well as defining new beans (based on these
  accesses) that are accessible to the remainder of the page via scripting variables and page scope attributes. Convenient
  mechanisms to create new beans based on the value of request cookies, headers, and parameters are also provided.
  </p>
  
  </section>
  
  <section href="resources" name="Bean Taglib Resources">
  
  <ul>
  <li><a href="../api/org/apache/struts/taglib/bean/package-summary.html#package_description">Bean Taglib Package Description</a></li>
  <li><a href="struts-bean.html">Bean Taglib API Reference</a></li>
  </ul>
  </section>
  
  </chapter></body></document>
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>