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 2003/12/10 01:57:50 UTC
cvs commit: jakarta-struts/doc/userGuide release-notes.xml
husted 2003/12/09 16:57:50
Modified: doc/userGuide release-notes.xml
Log:
+ Streamline release note format in preparation for 1.2.x updates.
Revision Changes Path
1.35 +145 -276 jakarta-struts/doc/userGuide/release-notes.xml
Index: release-notes.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/userGuide/release-notes.xml,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- release-notes.xml 27 Nov 2003 23:01:22 -0000 1.34
+++ release-notes.xml 10 Dec 2003 00:57:50 -0000 1.35
@@ -11,77 +11,55 @@
<body>
- <chapter name="6.1 Release Notes" href="release_notes">
- <section name="Beta Notes" href="beta">
+ <section name="Introduction" href="Introduction">
<p>This section contains the release notes for
<strong>nightly build</strong> of the Struts Framework,
for changes that have taken place since
<a href="release-notes-1.1.html">Version 1.1 </a>
- was released. For a complete list of changes since the last
- production release, see the <a href="#Introduction">Introduction</a> </p>
-
+ was released.
+ </p>
</section>
-<section name="Beta Fixes" href="beta.Changes">
-
- <p>
- <strong>ApplicationConfig:</strong> In Struts 1.2 was removed.
- </p>
-
-
-</section>
-
- <section name="Introduction" href="Introduction">
-
- <p>The remainder of this document contains the release notes for
- <strong>nightly build</strong> of the Struts Framework,
- and covers changes that have taken place since
- <a href="release-notes-1.1.html">Version 1.1</a>
- was released. The following sections cover
- <a href="#New">New Features</a> and <a href="#Changes">Changes</a>
- to Struts.</p>
-
- </section>
-
-
<section name="What's Included?" href="Included">
<p>The binary distribution of this release includes the following
files relevant to Struts:</p>
<ul>
- <li><code>INSTALL</code> - Brief installation instructions. See
- the <code>Struts Documentation Application</code>, or online at
- <a href="http://jakarta.apache.org/struts/">http://jakarta.apache.org/struts/</a>
- for more information.</li>
- <li><code>LICENSE</code> - The Apache Software Foundation license that
+ <li><code>INSTALL.txt</code> - Brief installation instructions.
+ For more detail, see the <code>Struts User Guide</code>, either through
+ the Struts Documentation application or online at
+ <a href="http://jakarta.apache.org/struts/">http://jakarta.apache.org/struts/</a>.
+ </li>
+ <li><code>LICENSE.txt</code> - The Apache Software Foundation license that
defines the terms under which you can use Struts (and other software
licensed by Apache).</li>
- <li><code>README</code> - A brief introduction to Struts.</li>
+ <li><code>README.txt</code> - A brief introduction to Struts.</li>
+ <li><code>contrib/</code> - Additional libraries developed by the Struts team
+ which are not yet part of the core distribution.</li>
<li><code>lib/</code> - Directory containing files you will need in
your own applications. The individual files of interest are:
<ul>
- <li><code>commons-*.jar</code> - Release packages from the
+ <li><code>commons-*-#.#.jar</code> - Release packages from the
<a href="http://jakarta.apache.org/commons/">Jakarta Commons
Project</a> that Struts relies on. You are welcome to use these
classes in your own applications. These JAR files should be
copied into the <code>/WEB-INF/lib</code> directory of
your web application.</li>
- <li><code>struts.jar</code> - JAR file that contains the compiled
- Java classes of Struts. You must
+ <li><code>jakarta-oro-#.#.jar</code> - JAR file containing the Jakarta
+ ORO package, utilitied by the Struts Valdiator. You must place
+ this file in the <code>/WEB-INF/lib</code> directory of
+ your web application to use the Struts Validator package.</li>
+ <li><code>struts-#.#.jar</code> - JAR file that contains the compiled
+ Java classes of Struts. You must
place this file in the <code>/WEB-INF/lib</code> directory of
your web application.</li>
- <li><code>struts-xxxxx.tld</code> - The tag library descriptor files
- for the Struts 1.1 tag libraries (bean, html, and logic).
- You must place these files in the <code>/WEB-INF</code>
- directory of your web application, and reference them with
+ <li><code>struts-*.tld</code> - The tag library descriptor files
+ for the Struts tag libraries (bean, html, logic, and nested).
+ When these taglibs are used, you must place these files in the <code>/WEB-INF</code>
+ directory of your web application and reference them with
appropriate <code><taglib></code> directives in your
web.xml file.</li>
- <li><code>jdbc2_0-stdext.jar</code> - The JDBC 2.0 Optional Package
- API classes (package <code>javax.sql</code>). You will need to
- include this file in the <code>/WEB-INF/lib</code> directory
- of your application, if it is not already made visible to web
- applications by your servlet container.</li>
<li><code>struts-config_1_2.dtd</code> - The Document Type Definition
(DTD) for the Struts 1.2 configuration file (which is typically named
<code>/WEB-INF/struts-config.xml</code>. Your configuration file
@@ -117,244 +95,136 @@
<li>Commons FileUpload 1.0</li>
<li>Commons Lang 2.0</li>
<li>Commons Logging 1.0.3</li>
- <li>Commons Validator 1.1.0</li>
+ <li>Commons Validator 1.1.1-dev</li>
</ul>
</section>
- <section name="What's New?" href="New">
-
- <p>Following are highlights of the new features. In the next section, we
- provide links to the JavaDocs for the affected classes.</p>
-
- <p><strong>New Configuration DTD</strong></p>
- <p> The Struts Configuration 1.1 DTD has been deprecated in favor of the
- <code><a href="http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd">struts-config_1_2.dtd</a></code>.
- In the Struts 1.2 release, existing Struts configuration files can be
- loaded using either DTD version. The new DTD adds two new elements <display-name>
- and <description> to the struts-config element.
- There are for use by struts config file tools and document generation.
- </p>
-
- <p><strong>New Dependencies on Commons packages</strong></p>
- <p>The resource component of Struts 1.1 has been found to be useful in
- general Java development (and not just useful for building Struts-based
- web applications), and have been migrated into the
- <a href="http://jakarta.apache.org/commons/">Jakarta Commons Project</a>.
- As a result, the current development version of Struts has been modified
- to rely on this Commons package, rather than the
- Struts internal version. In nearly every case, this involved changing
- only the <code>import</code> statements at the top of your classes. Any
- applications that utilize these classes will need to be modified in the
- same way. </p>
- <p>The following Commons packages contain the replacements for the
- corresponding Struts 1.1 classes:</p>
- <ul>
- <li><strong>Resources Package</strong>
- [<a href="http://jakarta.apache.org/commons/resources.html"><code>org.apache.commons.resources</code></a>] -
- <code>org.apache.struts.utils.MessageResources</code></li>
- </ul>
-
- <p><strong>NOTE! XML Parser Prerequisite Updated</strong></p>
-
- <p>Struts now depends on an XML parser that conforms to the JAXP/1.1
- (rather than JAXP/1.0) APIs. Parsers known to work include the JAXP/1.1
- reference implementation, and Xerces 1.3.1.</p>
-
- <p><strong>SOURCE DEVELOPERS NOTE! Ant Prerequisite Updated</strong></p>
- <p>To build Struts from source Ant 1.5.2 or later is now required. This
- does not affect developers that use Struts from the binary distribution.</p>
-
-
- <p>The source for these components is available in the Struts source
- distribution. Binary distributions may also be made available with the Struts
- download area. As optional components, these products have their own
- release cycles.</p>
-
- <p><strong>Action Package Additions</strong></p>
- <p>The following new features have been added to the basic controller
- framework [<code>org.apache.struts.action</code>]:</p>
-
- <p><strong>Actions Package Additions</strong></p>
- <p>The following new features have been added to the adapters between the
- incoming HTTP request and the corresponding business logic
- framework [<code>org.apache.struts.actions</code>]:</p>
- <ul>
- <li>The DispatchAction now provides default cancel handler that can be overridden.
- It also also possible to specify the default handler name.</li>
- <li>The LookupDispatchAction now provides default cancel handler that can be overridden.
- It also also possible to specify the default handler name.</li>
- </ul>
-
- <p><strong>Util Package Additions</strong></p>
- <p>The following new features have been added to the utility classes
- [<code>org.apache.struts.util</code>]:</p>
-
- <p><strong>Validator Package Additions</strong></p>
- <p>The following new features have been added to the validator classes
- [<code>org.apache.struts.validator</code>]:</p>
- <ul>
- <li>The ValidatorPlugin: It is now possible to force the client side
- Javascript validation to check all constraints, instead of stopping
- at the first error. By setting a new property, stopOnFirstError,
- on the validator plug in tag to false. This is in the struts-config.xml as follow:
- <pre>
- <plug-in className="org.apache.struts.validator.ValidatorPlugIn">
- <set-property property="pathnames"
- value="/WEB-INF/validation.xml,/WEB-INF/validator-rules.xml"/>
- <set-property property="stopOnFirstError" value="true"/>
- </plug-in>
- </pre>
- </li>
- <li>validator-rules.xml[intRange]: IntRange now checks select-one and radio fields.
- Example:
- This allows populating combo boxes with valid choices plus one additional choice
- with a caption something like "Choose one" and a value 0f "-1".
- Then when the user attempts to submit the form, you can look for the value of
- "-1" and yell at them if they failed to pick something.
+ <section name="What Changed?" href="Changes">
+ <p><strong>Configuration Changes</strong> [<code>/conf/shared</code>]</p>
+ <ul>
+ <li>
+ <code><a href="http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd">struts-config_1_2.dtd</a></code>
+ is preferred to the deprecated Struts Configuration 1.1 DTD.
+ The new DTD adds two new elements <display-name>
+ and <description> to the struts-config element.
+ These elements are for use by struts config file tools and document generation.
+ In the Struts 1.2.x series, existing Struts configuration files can be
+ loaded using either DTD version.
+ </li>
+ </ul>
+
+ <p><strong>Action Package Changes</strong> [<code>org.apache.struts.action</code>]</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>Actions Package Changes</strong> [<code>org.apache.struts.actions</code>]</p>
+ <ul>
+ <li>The DispatchAction now provides default cancel handler that can be overridden.
+ It also also possible to specify the default handler name.</li>
+ <li>The LookupDispatchAction now provides default cancel handler that can be overridden.
+ It also also possible to specify the default handler name.</li>
+ </ul>
+
+ <p><strong>Config Package</strong> [<code>org.apache.struts.config</code>]</p>
+ <ul>
+ <li>ApplicationConfig: removed in favor of ModuleConfig.</li>
+ </ul>
+
+ <p><strong>Plugins Package</strong> [<code>org.apache.struts.plugins</code>]</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>Bean Taglib Package Changes</strong> [<code>org.apache.struts.taglib.bean</code>]</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>HTML Taglib Package Changes</strong> [<code>org.apache.struts.taglib.html</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>Logic Taglib Package Changes</strong> [<code>org.apache.struts.taglib.logic</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>Nested Taglib Package Changes</strong> [<code>org.apache.struts.nested.logic</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>Tiles Taglib Package Changes</strong> [<code>org.apache.struts.tiles.logic</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>Tiles Package Changes</strong> [<code>org.apache.struts.tiles</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
- </li>
-
- </ul>
-
- <p><strong>HTML Taglib Package Additions</strong></p>
- <p>The following new features have been added to the
- <em>struts-html</em> custom tag library [<code>org.apache.struts.taglib.html</code>]:</p>
-
- <p><strong>Logic Taglib Package Additions</strong></p>
- <p>The following new features have been added to the
- <em>struts-logic</em> custom tag library [<code>org.apache.struts.taglib.logic</code>]:</p>
-
-
- <p><strong>Documentation Additions</strong></p>
- <p>The following new features have been added to the Struts Documentation
- application (and corresponding contents on the Struts web site):</p>
-
- </section>
-
- <section name="Operational Changes and Bug Fixes" href="Changes">
-
- <p><strong>Struts Configuration Changes</strong></p>
- <p>The following changes and bug fixes have occurred in the configuration
- files related to Struts:</p>
- <ul>
- <li>Japanese resources updates for Struts, its example, upload, tiles-documentation.</li>
- </ul>
- <p><strong>Config Package</strong></p>
-
- <p><strong>Action Package Changes</strong></p>
- <p>The following changes and bug fixes have occurred in the basic
- controller framework (package <code>org.apache.struts.action</code>):</p>
-
- <p><strong>Upload Package Changes</strong></p>
- <p>The following changes and bug fixes have occurred in the file upload
- package (package <code>org.apache.struts.upload</code>):</p>
- <ul>
- <li>None.</li>
- </ul>
-
- <p><strong>Utility Package Changes</strong></p>
- <p>The following changes and bug fixes have occurred in the utilities
- (package <code>org.apache.struts.util</code>):</p>
- <ul>
- <li>RequestUtils: </li>
- </ul>
-
- <p><strong>Bean Taglib Package Changes</strong></p>
- <p>The following changes and bug fixes have occurred in the
- <em>struts-bean</em> custom tag library
- [<code>org.apache.struts.taglib.bean</code>]:</p>
-
- <p><strong>HTML Taglib Package Changes</strong></p>
- <p>The following changes and bug fixes have occurred in the
- <em>struts-html</em> custom tag library (package
- <code>org.apache.struts.taglib.html</code>):</p>
-
- <p><strong>Logic Taglib Package Changes</strong></p>
- <p>The following changes and bug fixes have occurred in the
- <em>struts-logic</em> custom tag library (package
- <code>org.apache.struts.taglib.logic</code>):</p>
- <ul>
- <li>None.</li>
- </ul>
-
- <p><strong>Documentation Application Changes</strong></p>
- <p>The following changes and bug fixes to the Struts Documentation
- application (and corresponding contents on the Struts web site) have
- occurred:</p>
-
- <p><strong>MailReader Example Application Changes</strong></p>
- <p>The following changes and bug fixes to the Struts MailReader Example Application
- have occurred:</p>
-
- <p><strong>Template Example Application Changes</strong></p>
- <p>The following changes and bug fixes to the Struts Template Example
- Application have occurred:</p>
- <ul>
- <li>Removed.</li>
- </ul>
-
- <p><strong>Exercise Taglib Example Application Changes</strong></p>
- <p>The following changes and bug fixes to the Struts Exercise Taglib Example
- Application have occurred:</p>
-
- </section>
-
- <section name="What's different?" href="diff">
-
- <p>This section provides links to the Struts JavaDoc for any classes that have
- been added or deprecated since the Struts 1.0 release.
- </p>
-
- <p><strong>Previously deprecated classes and packages removed in Struts 1.2</strong></p>
- <ul>
- <li>Removed:
- <code>org.apache.struts.xxxx</code>
- </li>
- </ul>
-
- <p><strong>Packages added in Struts 1.2</strong></p>
-
-
- <p><strong>Classes added in Struts 1.2</strong></p>
- <p>action</p>
-
- <p>actions</p>
-
- <p>taglib.html</p>
-
- <p>taglib.logic</p>
+ <p><strong>Upload Package Changes</strong> [<code>org.apache.struts.upload</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
- <p>upload</p>
+ <p><strong>Utility Package Changes</strong> [<code>org.apache.struts.util</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>Validator Package Changes</strong> [<code>org.apache.struts.validator</code>]</p>
+ <ul>
+ <li>initModuleConfigFactory()</li>
+ <li>methods created for backward-compatiblity only</li>
+ <li>isStopOnFirstError</li>
+ <li>setStopOnFirstError</li>
+ <li>validator-rules.xml, range() is deprecated - use intRange() instead.</li>
+ </ul>
+
+ <ul>
+ <li>The ValidatorPlugin: It is now possible to force the client side
+ Javascript validation to check all constraints, instead of stopping
+ at the first error. By setting a new property, stopOnFirstError,
+ on the validator plug in tag to false. This is in the struts-config.xml as follow:
+<pre>
+<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
+<set-property property="pathnames"
+ value="/WEB-INF/validation.xml,/WEB-INF/validator-rules.xml"/>
+<set-property property="stopOnFirstError" value="true"/>
+</plug-in>
+</pre>
+ </li>
+ <li>validator-rules.xml[intRange]: IntRange now checks select-one and radio fields.
+ Example:
+ This allows populating combo boxes with valid choices plus one additional choice
+ with a caption something like "Choose one" and a value 0f "-1".
+ Then when the user attempts to submit the form, you can look for the value of
+ "-1" and yell at them if they failed to pick something.
+ </li>
+ </ul>
+
+ <p><strong>Documentation Application Changes</strong> [<code>struts-documentation.war</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>MailReader Example Application Changes</strong> [<code>struts-example.war</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
+
+ <p><strong>Exercise Taglib Example Application Changes</strong> [<code>struts-taglib-exercise.war</code>]:</p>
+ <ul>
+ <li>No signficant changes.</li>
+ </ul>
- <p>util</p>
-
- <p><strong>Classes with members added in Struts 1.2</strong></p>
- <p><a href="../api/org/apache/struts/action/ActionServlet.html">action.A</a><a href="../api/org/apache/struts/action/ActionServlet.html">ActionServlet</a></p>
- <ul>
- <li>initModuleConfigFactory()</li>
- <li>methods created for backward-compatiblity only</li>
- </ul>
- <p><a href="../api/org/apache/struts/validator/ValidatorPlugin.html">validator.html</a></p>
- <ul>
- <li>isStopOnFirstError</li>
- <li>setStopOnFirstError</li>
- </ul>
- <p><strong>Classes deprecated between Struts 1.1 and Struts 1.2</strong></p>
- <p>action</p>
- <ul>
- <li><a href="../api/org/apache/struts/xxx/xxxx.html"> xxx</a></li>
- </ul>
-
- <p><strong>Classes with members deprecated between Struts 1.1 and Struts 1.2</strong></p>
- <p><a href="../api/org/apache/struts/xxxx/xxxx.html">class.method</a></p>
-
-
- <p><strong>Classes with members removed between Struts 1.1 and Struts 1.2</strong></p>
- <p>validator-rules.xml, range() - use intRange() instead.</p>
-
-</section>
+ </section>
<section>
<p class="right">
@@ -362,7 +232,6 @@
</p>
</section>
-</chapter>
</body>
</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: struts-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: struts-dev-help@jakarta.apache.org