struts-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From craig...@locus.apache.org
Subject cvs commit: jakarta-struts/src/doc installation.xml release.xml
Date Fri, 03 Nov 2000 01:54:33 GMT
craigmcc    00/11/02 17:54:33

  Modified:    .        README
               src/doc  installation.xml release.xml
  Log:
  Update various docco to reflect the fact that there are now multiple tag
  libraries, and the Java2 baseline requirement for 1.0.
  
  Revision  Changes    Path
  1.10      +17 -18    jakarta-struts/README
  
  Index: README
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/README,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- README	2000/09/11 20:02:26	1.9
  +++ README	2000/11/03 01:54:32	1.10
  @@ -1,4 +1,4 @@
  -$Id: README,v 1.9 2000/09/11 20:02:26 craigmcc Exp $
  +$Id: README,v 1.10 2000/11/03 01:54:32 craigmcc Exp $
   
   				Struts
   				======
  @@ -35,12 +35,10 @@
   application).  If you simply wish to use the Struts custom tag library,
   and not the MVC framework, only the steps marked (*) are required.
   
  -- (*) Download and install a version 1.1 or later Java Development Kit
  -  implementation for your operating system platform.  Note that some
  -  Struts classes require Java2 (that is, JDK 1.2.2 or later) to
  -  operate successfully.  Define an environment variable JAVA_HOME
  -  that points at the base directory of your JDK installation, and
  -  add the directory "$JAVA_HOME/bin" to your PATH variable.
  +- (*) Download and install a Java2 (version 1.2 or later) Java Development Kit
  +  Kit implementation for your operating system platform.  Define an environment
  +  variable JAVA_HOME that points at the base directory of your JDK
  +  installation, and add the directory "$JAVA_HOME/bin" to your PATH variable.
   
   - Download and install an XML parser that is compatible with the Java
     API for XML Parsing (JAXP) specification.  A useful XML parser is the
  @@ -54,7 +52,7 @@
   - (*) Download and install a servlet container that supports the Servlet
     API Specification, version 2.2 or later, and the JavaServer Pages (JSP)
     Specification, version 1.1 or later.  A useful servlet container is
  -  Tomcat, version 3.1 or later, that is available at
  +  Tomcat, version 3.2 or later, that is available at
     <http://jakarta.apache.org>.
   
   - (*) Download and unpack a Struts binary distribution, available from
  @@ -70,7 +68,7 @@
     techniques supported by that container.  (For Tomcat, simply copy this
     file to the $TOMCAT_HOME/webapps directory and restart Tomcat).
   
  -- (*) Copy the file "lib/struts.tld" from the Struts distribution into the
  +- (*) Copy the files "lib/struts*.tld" from the Struts distribution into the
     "WEB-INF" directory of your web application.
   
   - (*) Copy the file "lib/struts.jar" from the Struts distribution into the
  @@ -84,23 +82,24 @@
     example application (see below) for an example of how this is done.
   
   - (*) Modify the "WEB-INF/web.xml" file for your web application to include
  -  a tag library declaration like this:
  +  a tag library declaration like this for each Struts tag library you will
  +  be using:
   
   	<taglib>
  -	    <taglib-uri>/WEB-INF/struts.tld</taglib-uri>
  -	    <taglib-location>/WEB-INF/struts.tld</taglib-location>
  +	    <taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri>
  +	    <taglib-location>/WEB-INF/struts-bean.tld</taglib-location>
   	</taglib>
   
  -- Create a file "WEB-INF/action.xml" that defines the mappings for your
  -  requests to specific action classes.  Use the "action.xml" file from
  +- Create a file "WEB-INF/struts-config.xml" that defines the mappings for your
  +  requests to specific action classes.  Use the "struts-config.xml" file from
     the example application (see below) as a guide.
   
   - (*) In each JSP page that will use the Struts custom tags, add a line at
  -  the top of the page like this:
  +  the top of the page like this (for each Struts tag library needed):
   
  -	<%@ taglib uri="/WEB-INF/struts.tld" prefix="struts" %>
  +	<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="struts-bean" %>
   
  -  (If you wish, you can use a prefix other that "struts").
  +  (If you wish, you can use a prefix other that "struts-bean").
   
   - When compiling your web application components, be sure that the
     "struts.jar" file (copied above) is included on the CLASSPATH environment
  @@ -160,7 +159,7 @@
   download and install a source distribution of Struts from
   <http://jakarta.apache.org/builds/jakarta-struts/nightly/src>.  You will also
   need a recent nightly build of the Ant project development tool (you *must*
  -use a version later than the Ant 3.1 release).
  +use version 1.2 or later of Ant).
   
   Before committing any changes to the Struts CVS repository, you must do a
   "build clean" followed by a "build dist", to ensure that everything compiles
  
  
  
  1.5       +26 -22    jakarta-struts/src/doc/installation.xml
  
  Index: installation.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/src/doc/installation.xml,v
  retrieving revision 1.4
  retrieving revision 1.5
  diff -u -r1.4 -r1.5
  --- installation.xml	2000/09/26 19:45:02	1.4
  +++ installation.xml	2000/11/03 01:54:32	1.5
  @@ -15,10 +15,8 @@
     other software packages, as follows:</p>
     <ul>
     <li><strong>Java Development Kit</strong> - You must download and install
  -      a version 1.1 (or later) Java Development Kit implementation for your
  -      operating system platform.  You <em>must</em> have a Java2 version
  -      (JDK 1.2 or later) to build the Struts source distribution, and several
  -      of the custom tags in the Struts library require Java2 to execute.
  +      a Java2 (version 1.2 or later) Java Development Kit implementation for
  +      your operating system platform.
         A good starting point for locating Java Development Kit distributions is
         <a href="http://java.sun.com/j2se">http://java.sun.com/j2se</a>.</li>
     <li><strong>Servlet Container</strong> - You must download and install
a
  @@ -28,12 +26,12 @@
         <a href="http://jakarta.apache.org/tomcat">Tomcat</a> (version 3.1
         or later required, version 3.2 or later recommended).</li>
     <li><strong>Ant Build System</strong> - If you are building Struts
from the
  -      source distribution, you must download and install version 1.1 or later
  +      source distribution, you must download and install version 1.2 or later
         of the <a href="http://jakarta.apache.org/ant">Ant</a> build system.
         This package is also strongly recommended for use in developing your
         own web applications based on Struts.
         <ul>
  -      <li>If you are using the release version of Ant version 1.1, you will
  +      <li>If you are using the release version of Ant version 1.2, you will
             also need to download the "optional.jar" file that contains the
             implementation of Ant's <code>&lt;style&gt;</code> command.</li>
         </ul></li>
  @@ -46,7 +44,7 @@
         </li>
     <li><strong>XML Parser</strong> - Struts requires the presence of an
XML
         parser that is compatible with the Java API for XML Parsing (JAXP)
  -      specification.  You can download and install the JAXP
  +      specification, 1.0 or later.  You can download and install the JAXP
         <a href="http://java.sun.com/xml">reference implementation</a>,
         which is required for building the Struts source distribution.  In
         Struts-based web applications, you may replace the reference
  @@ -121,10 +119,10 @@
       <li><strong>lib/struts.jar</strong> - This JAR file contains all
of the
           Java classes included in Struts.  It should be copied into the
           <code>WEB-INF/lib</code> directory of your web application.</li>
  -    <li><strong>lib/struts.tld</strong> - This is the "tag library descriptor"
  -        file that describes the custom tags in the Struts library.  It should
  -        be copied into the <code>WEB-INF</code> directory of your web
  -        application.</li>
  +    <li><strong>lib/struts*.tld</strong> - These are the "tag library
  +        descriptor" files that describe the custom tags in the various Struts
  +        tag libraries.  They should be copied into the <code>WEB-INF</code>
  +        directory of your web application.</li>
       <li><strong>webapps/struts-documentation.war</strong> - This is a
           "web application archive" file containing all of the Struts
           documentation found on the
  @@ -162,32 +160,38 @@
           to include the following tag library declarations:
           <pre>
           &lt;taglib&gt;
  -          &lt;taglib-uri&gt;/WEB-INF/struts.tld&lt;/taglib-uri&gt;
  -          &lt;taglib-location&gt;/WEB-INF/struts.tld&lt;/taglib-location&gt;
  +          &lt;taglib-uri&gt;/WEB-INF/struts-bean.tld&lt;/taglib-uri&gt;
  +          &lt;taglib-location&gt;/WEB-INF/struts-bean.tld&lt;/taglib-location&gt;
           &lt;/taglib&gt;
   
           &lt;taglib&gt;
  -          &lt;taglib-uri&gt;/WEB-INF/struts-bean.tld&lt;/taglib-uri&gt;
  -          &lt;taglib-location&gt;/WEB-INF/struts-bean.tld&lt;/taglib-location&gt;
  +          &lt;taglib-uri&gt;/WEB-INF/struts-form.tld&lt;/taglib-uri&gt;
  +          &lt;taglib-location&gt;/WEB-INF/struts-form.tld&lt;/taglib-location&gt;
           &lt;/taglib&gt;
   
           &lt;taglib&gt;
             &lt;taglib-uri&gt;/WEB-INF/struts-logic.tld&lt;/taglib-uri&gt;
             &lt;taglib-location&gt;/WEB-INF/struts-logic.tld&lt;/taglib-location&gt;
           &lt;/taglib&gt;
  +
  +        &lt;taglib&gt;
  +          &lt;taglib-uri&gt;/WEB-INF/struts-template.tld&lt;/taglib-uri&gt;
  +          &lt;taglib-location&gt;/WEB-INF/struts-template.tld&lt;/taglib-location&gt;
  +        &lt;/taglib&gt;
           </pre>
           </li>
  -    <li>Create a file <code>WEB-INF/action.xml</code> that defines the
action
  -        mappings for your specific application.  You can use the
  -        <code>action.xml</code> file from the Struts example application
  -        for a detailed example of the required syntax.</li>
  +    <li>Create a file <code>WEB-INF/struts-config.xml</code> that defines
the
  +        action mappings and other characteristics of your specific application.
  +        You can use the <code>struts-config.xml</code> file from the Struts
  +        example application for a detailed example of the required syntax.</li>
       <li>At the top of each JSP page that will use the Struts custom tags,
           add line(s) declaring the Struts custom tag libraries used on
           this particular page, like this:
           <pre>
  -        &lt;@ taglib uri="/WEB-INF/struts.tld" prefix="struts" %&gt;
  -        &lt;@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %&gt;
  -        &lt;@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic" %&gt;
  +        &lt;@ taglib uri="/WEB-INF/struts-bean.tld" prefix="struts-bean" %&gt;
  +        &lt;@ taglib uri="/WEB-INF/struts-form.tld" prefix="struts-form" %&gt;
  +        &lt;@ taglib uri="/WEB-INF/struts-logic.tld" prefix="struts-logic" %&gt;
  +        &lt;@ taglib uri="/WEB-INF/struts-template.tld" prefix="struts-template" %&gt;
           </pre>
           </li>
       <li>When compiling the Java classes that comprise your application, be sure
  
  
  
  1.6       +14 -0     jakarta-struts/src/doc/release.xml
  
  Index: release.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-struts/src/doc/release.xml,v
  retrieving revision 1.5
  retrieving revision 1.6
  diff -u -r1.5 -r1.6
  --- release.xml	2000/10/16 05:02:37	1.5
  +++ release.xml	2000/11/03 01:54:32	1.6
  @@ -15,6 +15,9 @@
     <a href="#New">New Features</a> and <a href="#Changes">Changes</a>
since
     the <strong>Version 0.5</strong> of Struts was made available.</p>
   
  +  <p>One global new feature to take note of is that Struts 1.0 requires
  +  a Java2 (JDK 1.2 or later) platform on which to run.</p>
  +
     </section>
   
   
  @@ -89,6 +92,17 @@
         &lt;struts-bean:struts id="link" forward="success"/&gt;
         &lt;struts-bean:write name="link" property="path"/&gt;
         </pre></li>
  +  </ul>
  +
  +  <p>The following major new features have been added to the
  +  <em>Struts Example Application</em>:</p>
  +  <ul>
  +  <li>The form beans used in the example application now use request scope
  +      rather than session scope.  This is the preferred approach for single
  +      page forms that contain <em>all</em> of your relevant properties,
  +      because there is no need to maintain such form beans across requests.
  +      Note that the action classes have been coded so that they work with
  +      either request scope or session scope beans.</li>
     </ul>
   
     </section>
  
  
  

Mime
View raw message