husted 01/11/21 07:19:58
Modified: doc Tag: STRUTS_1_0_BRANCH release-notes-1.0.1.xml
project.xml index.xml
Log:
Update documentation in anticipation of release candidate.
Revision Changes Path
No revision
No revision
1.1.2.2 +65 -33 jakarta-struts/doc/release-notes-1.0.1.xml
Index: release-notes-1.0.1.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/release-notes-1.0.1.xml,v
retrieving revision 1.1.2.1
retrieving revision 1.1.2.2
diff -u -r1.1.2.1 -r1.1.2.2
--- release-notes-1.0.1.xml 2001/07/05 11:45:55 1.1.2.1
+++ release-notes-1.0.1.xml 2001/11/21 15:19:58 1.1.2.2
@@ -1,5 +1,5 @@
<?xml version="1.0"?>
-<document url="./release-notes-1.0.xml">
+<document url="./release-notes-1.01.xml">
<properties>
<author>Craig R. McClanahan</author>
@@ -13,20 +13,24 @@
<section name="Introduction" href="Introduction">
<p>This document contains the release notes for
- <strong>Version 1.0.1</strong> of the Struts Framework,
+ <strong>Version 1.0.1 </strong> of the Struts Framework,
and covers changes that have taken place since
<a href="release-notes-1.0.html">Version 1.0</a>
was released. The following sections cover
<a href="#New">New Features</a> and <a href="#Changes">Changes</a>
to Struts.</p>
+ <p>This version is unreleased, but available in the
+ CVS as the STRUTS_1_0_BRANCH. This version is intended a near-term
+ release to cover bug-fixes only; no new functionality.</p>
+
</section>
<section name="What's Included?" href="Included">
<p>The binary distribution of this release includes the following
- files relevant to Struts 1.0:</p>
+ files relevant to Struts 1.1:</p>
<ul>
<li><code>INSTALL</code> - Brief installation instructions. See
the <code>Struts Documentation Application</code>, or online at
@@ -37,26 +41,24 @@
licensed by Apache).</li>
<li><code>README</code> - A brief introduction to Struts.</li>
<li><code>lib/</code> - Directory containing files you will need in
- your own applications. The individual files of interest are:
+ your own applications. The individual files of interest are:</li>
<ul>
<li><code>struts.jar</code> - JAR file that contains the compiled
- Java classes for both version 0.5 and 1.0 of Struts. You must
+ Java classes for version 1.0 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.0 tag libraries (bean, html, logic, and
+ for the Struts 1.1 tag libraries (bean, html, logic, and
template). 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. <strong>NOTE</strong> - The struts-form.tld
- file is deprecated; you should use the struts-html.tld file
- instead.</li>
+ 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_0.dtd</code> - The document type descriptor
+ <li><code>struts-config_1_1.dtd</code> - The document type descriptor
(DTD) for the Struts configuration file (which is typically named
<code>/WEB-INF/struts-config.xml</code>. Your configuration file
will be validated against an internal copy of this DTD -- this
@@ -67,9 +69,14 @@
<li><code>web-app_2_3.dtd</code> - The document type descriptor (DTD)
for web.xml files conforming to the Servlet 2.3 specification.
This copy is for reference purposes only.</li>
- </ul></li>
- <li><code>webapps/</code> - Web Application Archive (WAR) files for the
- web applications that are included with Struts.</li>
+ </ul>
+ <li><code>webapps/</code> - Web Application Archive (WAR) files for the
+ web applications that are included with Struts.</li>
+ </ul>
+
+ <p>The struts 0.5 milestone API release is no longer supported.
+ and has been removed as of Struts 1.1:</p>
+ <ul>
</ul>
</section>
@@ -77,48 +84,43 @@
<section name="What's New?" href="New">
- <p><strong>DEPRECATIONS</strong>:</p>
- <ul>
- <li>None.</li>
- </ul>
<p>The following new features have been added to the basic controller
framework (package <code>org.apache.struts.action</code>):</p>
<ul>
- <li>Additional fix for file corruption problem with uploads and new line
characters.</li>
</ul>
<p>The following new features have been added to the utility classes
(package <code>org.apache.struts.util</code>):</p>
<ul>
- <li>None.</li>
+ <li>LocalStrings: Correct message regarding replaceable parameter so that it
does not append an extraneous character.</li>
+ <li>Add LabelValueBean class. This defines a collection of name/value pairs
that can be used with the >html:options> tag, and elsewhere.</li>
+ <li>MessageResources: Escape any single quote characters that are included in
the specified message string.</li>
+ <li>Allow a transaction token to be the only parameter in
computeParameters().</li>
+ <li>Change RequestUtils to encode ampersands when building a query string.</li>
</ul>
<p>The following new features have been added to the
<em>struts-html</em> custom tag library (package
<code>org.apache.struts.taglib.html</code>):</p>
<ul>
- <li>None.</li>
</ul>
<p>The following new features have been added to the
<em>struts-logic</em> custom tag library (package
<code>org.apache.struts.taglib.logic</code>):</p>
<ul>
- <li>None.</li>
</ul>
<p>The following new features have been added to the
<em>struts-template</em> custom tag library (package
<code>org.apache.struts.taglib.template</code>):</p>
<ul>
- <li>None.</li>
</ul>
<p>The following new features have been added to the Struts Documentation
application (and corresponding contents on the Struts web site):</p>
<ul>
- <li>None.</li>
</ul>
</section>
@@ -129,48 +131,63 @@
<p>The following changes and bug fixes have occurred in the configuration
files related to Struts:</p>
<ul>
- <li>None.</li>
</ul>
<p>The following changes and bug fixes have occurred in the basic
controller framework (package <code>org.apache.struts.action</code>):</p>
<ul>
- <li>None.</li>
+ <li>Modify ActionForm class to use ActionServletWrapper rather than expose
ActionServlet.</li>
+ <li>Add ActionServletWrapper class. Used by ActionForm to prevent the Public
String properties of ActionServlet from being changed via a query string.</li>
+ <li>The logic for creating an ActionErrors or ActionMessages object has been
moved to a utility method in RequestUtils. The JspException message is also generated
in RequestUtils.</li>
+ <li>Unconditionally pass the selected mapping as a request attribute under key
Action.MAPPING_KEY, even if no form bean is specified.</li>
+ <li>Avoid a NullPointerException in corner cases caused by failed
initialization of ActionServlet.</li>
</ul>
<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>
+ <li>Improved error-handling on out of bounds conditions.</li>
+ <li>Additional fix for file corruption problem with uploads and new line
characters.</li>
</ul>
<p>The following changes and bug fixes have occurred in the utilities
(package <code>org.apache.struts.util</code>):</p>
<ul>
- <li>None.</li>
+ <li>Modify RequestUtils class to use ActionServletWrapper rather than expose
ActionServlet.</li>
+ <li>Added error message for the getActionErrors and getActionMessages
method.</li>
+ <li>Added a getActionErrors and getActionMessages methods to generate the
correct corresponding object based on the object retrieved from request scope based on
the key passed in.</li>
+ <li>The logic for creating an ActionErrors or ActionMessages object has been
moved to a utility method in RequestUtils. The JspException message is also generated
in RequestUtils.</li>
+ <li><code>ConvertUtils.convertCharacter()</code> will now detect empty strings
and return the default value.</li>
</ul>
<p>The following changes and bug fixes have occured in the
<em>struts-bean</em> custom tag library (package
<code>org.apache.struts.taglib.bean</code>):</p>
<ul>
- <li>None.</li>
+ <li>Correct the generated scripting variable type when the <bean:cookie>,
<bean:header>, or <bean:parameter> tag is used with the "multiple"
attribute.</li>
</ul>
<p>The following changes and bug fixes have occured in the
<em>struts-html</em> custom tag library (package
<code>org.apache.struts.taglib.html</code>):</p>
<ul>
- <li>None.</li>
+ <li>Fixed FormTag to exclude query string when identifying action mapping
name.</li>
+ <li>Correct MultiboxTagdoAfterBody() to return SKIP_BODY instead of
SKIP_PAGE.</li>
+ <li>Added the 'align' attribute to the <html:image> tag.</li>
+ <li>On the Options tag, if the property specified by the "property" attribute
returns null, it now throws an error message that indicates what the real problem is,
rather than causing an NPE.</li>
+ <li>Added 'style' and 'styleClass' attributes for <html:option> and
<html:options> tags.</li>
+ <li>Correctly URLEncode the query string parameter value on ImgTag, even if
there is only a single parameter.</li>
</ul>
+
<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>Added tags for checking if a message is present in general or for a
specific property. They retrieve an object from request scope just like the
html:errors and html:messages tags.</li>
<li>The <code><html:errors></code> when the property tag is
specified, errors are no longer printed if the specified property
- has no errors. Previously errors were always printed ! Future
+ has no errors. Previously errors were always printed! Future
enhancements would include additional attributes to always turn
off the header or footer. </li>
</ul>
@@ -179,21 +196,36 @@
application (and corresponding contents on the Struts web site) have
occurred:</p>
<ul>
- <li>None.</li>
+ <li>Add installation notes for Jetty.</li>
+ <li>In the Tag Developers Guide, add more detail regarding file upload
requirements.</li>
+ <li>In the Introduction, added references to basic background material.</li>
+ <li>In Building View Components, clarify that additional i18n support may be
provided by the browser, and is outside the scope of the framework.</li>
+ <li>In Building Controller Components, document 'validating' init-param, add
defaults for various parameters, clarify that some web.xml settings are not
Struts-specific.</li>
+ <li>Correct the example page in the User's Guide (Building View Components) to
reflect current practice.</li>
+ <li>Revised installation instructions for SilverStream and Resin.</li>
</ul>
<p>The following changes and bug fixes to the Struts Example Application
have occurred:</p>
<ul>
- <li>None.</li>
+ <li>Remove references to saving database data from "tour" document, since this
functionality was removed.</li>
</ul>
<p>The following changes and bug fixes to the Struts Template Example
Application have occurred:</p>
+ <ul>
+ </ul>
+
+ <p>The following changes and bug fixes to the Struts Exercise Taglib Example
+ Application have occurred:</p>
<ul>
- <li>None.</li>
+ <li>Added test case for <html:select> using <html:options> based on a
collection
+ saved in the page context.</li>
</ul>
</section>
+
+
</body>
+
</document>
1.1.2.5 +40 -25 jakarta-struts/doc/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/project.xml,v
retrieving revision 1.1.2.4
retrieving revision 1.1.2.5
diff -u -r1.1.2.4 -r1.1.2.5
--- project.xml 2001/07/05 11:45:56 1.1.2.4
+++ project.xml 2001/11/21 15:19:58 1.1.2.5
@@ -5,46 +5,61 @@
<title>Struts Framework</title>
- <menu name="Documentation">
+ <menu name="Welcome">
<item name="Home" href="index.html"/>
- <item name="Installation" href="installation.html"/>
- <item name="User Guide (1.0)" href="userGuide/index.html"/>
- <item name="Javadoc" href="api/index.html"/>
- <item name="Release Notes (1.0.1)" href="release-notes-1.0.1.html"/>
- <item name="Release Notes (1.0)" href="release-notes-1.0.html"/>
+ <item name="Kickstart FAQ" href="userGuide/kickstart.html"/>
+ <item name="User Guide" href="userGuide/index.html"/>
<item name="Resources" href="userGuide/resources.html"/>
<item name="Who We Are" href="userGuide/volunteers.html"/>
- <item name="TODO List (1.1)" href="todo-1.1.html"/>
</menu>
- <menu name="Java Developer Guides">
- <item name="Digester"
-
href="api/org/apache/struts/digester/package-summary.html#package_description"/>
- <item name="Utilities"
-
href="api/org/apache/struts/util/package-summary.html#package_description"/>
+ <menu name="Downloads">
+ <item name="Binaries"
href="http://jakarta.apache.org/site/binindex.html"/>
+ <item name="Source Code"
href="http://jakarta.apache.org/site/sourceindex.html"/>
+ <item name="Release Candidate"
href="http://jakarta.apache.org/builds/jakarta-struts/archives/v1.0.1-b1"/>
</menu>
- <menu name="Tag Library Guides">
+ <menu name="Getting Started">
+ <item name="Installation" href="installation-1.0.html"/>
+ <item name="Release Notes" href="release-notes-1.0.1.html"/>
+ <item name="Javadoc" href="api-1.0.1/index.html"/>
+ <item name="Mailing Lists"
href="http://jakarta.apache.org/site/mail.html"/>
+ <item name="Bug Database"
href="http://jakarta.apache.org/site/bugs.html"/>
+ </menu>
+
+ <menu name="Developer Guides">
<item name="Bean Tags"
-
href="api/org/apache/struts/taglib/bean/package-summary.html#package_description"/>
+
href="api-1.0/org/apache/struts/taglib/bean/package-summary.html#package_description"/>
<item name="HTML Tags"
-
href="api/org/apache/struts/taglib/html/package-summary.html#package_description"/>
+
href="api-1.0/org/apache/struts/taglib/html/package-summary.html#package_description"/>
<item name="Logic Tags"
-
href="api/org/apache/struts/taglib/logic/package-summary.html#package_description"/>
+
href="api-1.0/org/apache/struts/taglib/logic/package-summary.html#package_description"/>
<item name="Template Tags"
-
href="api/org/apache/struts/taglib/template/package-summary.html#package_description"/>
+
href="api-1.0/org/apache/struts/taglib/template/package-summary.html#package_description"/>
+ <item name="Digester"
+
href="api-1.0/org/apache/struts/digester/package-summary.html#package_description"/>
+ <item name="Utilities"
+
href="api-1.0/org/apache/struts/util/package-summary.html#package_description"/>
</menu>
- <menu name="Tag Library Reference">
- <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="Template Tags" href="struts-template.html"/>
+ <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="Template Tags"
+ href="struts-template.html"/>
</menu>
- <menu name="Old Documents">
- <item name="Tag Library (Old)" href="tags.html"/>
- <item name="User's Guide (Old)" href="users_guide.html"/>
+ <menu name="Current Development">
+ <item name="Release Plan (1.0.1)" href="release-plan-1.0.1.html"/>
+ <item name="Installation (nightly)" href="installation.html"/>
+ <item name="Release Notes (nightly)" href="release-notes.html"/>
+ <item name="Javadoc (nightly)" href="api/index.html"/>
+ <item name="Workflow Proposal" href="proposal-workflow.html"/>
+ <item name="TODO List" href="todo-1.1.html"/>
</menu>
</project>
1.2.2.5 +59 -13 jakarta-struts/doc/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/index.xml,v
retrieving revision 1.2.2.4
retrieving revision 1.2.2.5
diff -u -r1.2.2.4 -r1.2.2.5
--- index.xml 2001/10/20 05:04:05 1.2.2.4
+++ index.xml 2001/11/21 15:19:58 1.2.2.5
@@ -3,14 +3,14 @@
<properties>
<author>Craig R. McClanahan</author>
+ <author>Ted Husted</author>
<title>The Struts Framework Project</title>
</properties>
<body>
+ <section name="Welcome to Struts 1.0.1-b1" href="Welcome">
- <section name="Welcome to Struts" href="Welcome">
-
<p>Welcome to the Struts Framework! The goal of this project
is to provide an open source framework useful in building web applications
with Java <a href="http://java.sun.com/products/servlet";>Servlet</a> and
@@ -42,25 +42,71 @@
</section>
+ <section name="Learning About Struts" href="Docs">
- <section name="Acquiring Struts" href="Acquiring">
+ <p>The <a href="userGuide/kickstart.html"><b>Kickstart FAQ</b></a> quickly
answers
+ the most common questions about Struts.</p>
+
+ <p>A concise <a href="userGuide/index.html"><b>Users Guide</b></a> is also
provided
+ with the distribution. The User Guide introduces the Model View Controller
+ architecture, and how it relates to the major components of Struts. Several
Developer
+ Guides are also provided, to help you get started with the Struts tag extensions
and
+ utility packages.</p>
+
+ <p>For more detail about a specific class or package, the Struts
+ <a
href="http://jakarta.apache.org/struts/api-1.0.1/index.html";><b>Javadocs</b></a>
+ are comprehensive and carefully maintained. It is strongly recommended that
+ you refer to the <a
href="http://jakarta.apache.org/struts/api-1.0.1/index.html";>Javadoc</a>
+ for each class as you begin to use it, to be sure important features and options
+ are not overlooked. What you don't know, can't help you.</p>
+
+ <p>Of course, the only true documentation is the code itself. If you have any
questions
+ about how Struts actually works, do not hestate to <i>use the source</i>. For the
+ complete, buildable source code to the entire Struts framework, see the "src"
folder in
+ the <a
href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0/src/";><b>Struts 1.0
source distribution</b></a>.</p>
+
+ <p>The Struts <a href="userGuide/resources.html"><b>Resources</b></a> page
provides links to
+ everything else written about Struts, including books, articles, tutorials, and
sample
+ applications. There are also links to public sites "Powered by Struts". </p>
+
+ </section>
- <p>The final release of <strong>Struts 1.0</strong> has been created and
+ <section name="Acquiring the 1.0.1 Release Candidate" href="Acquiring">
+
+ <p>A <i>release candidate</i> for <strong>Struts 1.0.1</strong> has been created
and
made available at
- <a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0";>
- http://jakarta.apache.org/builds/jakarta-struts/release/v1.0</a>. The
- source code for this version of Struts can also be downloaded at
- <a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0/src";>
- http://jakarta.apache.org/builds/jakarta-struts/release/v1.0/src</a>.</p>
+ <a href="http://jakarta.apache.org/builds/jakarta-struts/archives/v1.0.1-b1";>
+ http://jakarta.apache.org/builds/jakarta-struts/archives/v1.0.1-b1</a>.</p>
+
+ <p>Check the <a href="release-notes-1.0.1.html">Release Notes</a>
+ for a summary of what new features have been added, and other significant
+ changes, since the Struts 1.0 release.</p>
+
+ </section>
+ <section name="Acquiring Struts" href="Acquiring">
+
+ <p>The <i>production release</i> of <strong>Struts 1.0</strong> is available in
+ in convenient binary distribution and also with complete source code.</p>
+
+ <ul>
+ <li><a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0";>
+ <b>Struts 1.0 Binary Distribution</b></a></li>
+ <li><a href="http://jakarta.apache.org/builds/jakarta-struts/release/v1.0/src";>
+ <b>Struts 1.0 Source Code Distribution</b></a></li>
+ </ul>
+
<p>Check the <a href="release-notes-1.0.html">Release Notes</a>
for a summary of what new features have been added, and other significant
changes, since the Struts 1.0-beta-3 release.</p>
- <hr width="75%"/>
-
- <p>You can acquire interim binary and source distributions of Struts from the
- following locations:</p>
+ </section>
+
+ <section name="Nightly Builds" href="Builds">
+
+ <p>For developers who are helping to develop Struts, or who just want
+ "the latest bits", the latest development version is made available each
+ morning. Use at your own risk!</p>
<ul>
<li>Download the source directly via
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
