--- [EMAIL PROTECTED] wrote: > rleland 2003/08/09 01:50:52 > > Modified: conf/share struts-config_1_2.dtd > doc/userGuide release-notes.xml > web/example/WEB-INF struts-config-registration.xml > struts-config.xml > Log: > Add two new elements <description-short> and <description-long> for > use > by struts config file tools and document generation. > Suggested by Jonas Björnerstedt
The only suggestion I could find in the archives was to add <display-name> and <description> elements. I'm confused by the two description fields. Is there a need for two different descriptions of the same struts-config.xml file? web.xml uses <description> and <display-name> so I think it would be better to match that. David > > Revision Changes Path > 1.4 +11 -2 jakarta-struts/conf/share/struts-config_1_2.dtd > > Index: struts-config_1_2.dtd > =================================================================== > RCS file: /home/cvs/jakarta-struts/conf/share/struts-config_1_2.dtd,v > retrieving revision 1.3 > retrieving revision 1.4 > diff -u -r1.3 -r1.4 > --- struts-config_1_2.dtd 4 Jul 2003 21:33:29 -0000 1.3 > +++ struts-config_1_2.dtd 9 Aug 2003 08:50:52 -0000 1.4 > @@ -82,9 +82,18 @@ > hierarchy, and contains nested elements for all of the other > configuration settings. > --> > -<!ELEMENT struts-config (data-sources?, form-beans?, > global-exceptions?, global-forwards?, action-mappings?, controller?, > message-resources*, plug-in*)> > +<!ELEMENT struts-config (description-short?, description-long?, > data-sources?, form-beans?, global-exceptions?, global-forwards?, > action-mappings?, controller?, message-resources*, plug-in*)> > <!ATTLIST struts-config id ID #IMPLIED> > > +<!-- The "description-short" element is a short descriptive phrase > that summarize the purpose of this > + struts-config. It is not used or read by struts and is only for > documentation or automated tools. > +--> > +<!ELEMENT description-short (#PCDATA)> > + > +<!-- The "description-long" element is a long descriptive phrase that > details the purpose of this > + struts-config. It is not used or read by struts and is only for > documentation or automated tools. > +--> > +<!ELEMENT description-long (#PCDATA)> > > <!-- The "data-sources" element describes a set of DataSource objects > [JDBC 2.0 > Standard Extension]. The individual DataSource objects are > configured through > > > > 1.27 +8 -33 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.26 > retrieving revision 1.27 > diff -u -r1.26 -r1.27 > --- release-notes.xml 30 Jul 2003 03:56:15 -0000 1.26 > +++ release-notes.xml 9 Aug 2003 08:50:52 -0000 1.27 > @@ -131,53 +131,28 @@ > <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. > + loaded using either DTD version. The new DTD adds two new > elements <description-short> > + and <description-long> for use by struts config file tools > and document generation. > </p> > > <p><strong>New Dependencies on Commons packages</strong></p> > - <p>Several components of Struts 1.0 have been found to be useful > in > + <p>The resource components 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 the Commons packages containing these classes, rather > than the > - Struts internal versions. In nearly every case, this involved > changing > + 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.0 classes:</p> > + corresponding Struts 1.1 classes:</p> > <ul> > <li><strong>BeanUtils Package</strong> > - [<a > href="http://jakarta.apache.org/commons/beanutils.html"><code>org.apache.commons.beanutils</code></a>] > - > - <code>org.apache.struts.utils.BeanUtils</code>, > - <code>org.apache.struts.utils.ConvertUtils</code>, and > - <code>org.apache.struts.utils.PropertyUtils</code>.</li> > - <li><strong>Collections Package</strong> > - [<a > href="http://jakarta.apache.org/commons/collections.html"><code>org.apache.commons.collections</code></a>] > - > - <code>org.apache.struts.util.ArrayStack</code>, > - <code>org.apache.struts.util.FastArrayList</code>, > - <code>org.apache.struts.util.FastHashMap</code>, > - <code>org.apache.struts.util.FastTreeMap</code>.</li> > - <li><strong>Digester Package</strong> - > - [<a > href="http://jakarta.apache.org/commons/digester.html"><code>org.apache.commons.digester</code></a>] > - > - <code>org.apache.struts.digester.*</code>.</li> > + [<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>The following Commons packages are also now used by various > components > - of the Struts framework:</p> > - <ul> > - <li><strong>Database Connection Pool Package</strong> > - [<a > href="http://jakarta.apache.org/commons/dbcp.html"><code>org.apache.commons.dbpc</code></a>]</li> > - <li><strong>FileUpload Package</strong> > - [<a > href="http://cvs.apache.org/viewcvs/jakarta-commons-sandbox/fileupload/"><code>org.apache.commons.fileupload</code></a>]</li> > - <li><strong>Logging Package</strong> > - [<a > href="http://jakarta.apache.org/commons/logging.html"><code>org.apache.commons.logging</code></a>]</li> > - <li><strong>Pool Package</strong> > - [<a > href="http://jakarta.apache.org/commons/pool/index.html"><code>org.apache.commons.pool</code></a>]</li> > - <li><strong>Validator Package</strong> > - [<a > href="http://cvs.apache.org/viewcvs/jakarta-commons/validator/"><code>org.apache.commons.validator</code></a>]</li> > - </ul> > - > > <p><strong>NOTE! XML Parser Prerequisite Updated</strong></p> > > > > > 1.2 +10 -6 > jakarta-struts/web/example/WEB-INF/struts-config-registration.xml > > Index: struts-config-registration.xml > =================================================================== > RCS file: > /home/cvs/jakarta-struts/web/example/WEB-INF/struts-config-registration.xml,v > retrieving revision 1.1 > retrieving revision 1.2 > diff -u -r1.1 -r1.2 > --- struts-config-registration.xml 25 Apr 2003 03:07:45 -0000 1.1 > +++ struts-config-registration.xml 9 Aug 2003 08:50:52 -0000 1.2 > @@ -1,15 +1,19 @@ > <?xml version="1.0" encoding="ISO-8859-1" ?> > > <!DOCTYPE struts-config PUBLIC > - "-//Apache Software Foundation//DTD Struts Configuration > 1.1//EN" > - > "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd"> > + "-//Apache Software Foundation//DTD Struts Configuration > 1.2//EN" > + > "http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd"> > > -<!-- > +<struts-config> > + <description-short><![CDATA[ > + registration > + ]]> > + </description-short> > + <description-long><![CDATA[ > This is the Struts configuration file for the registration > portion of the example application, using the proposed new > syntax. > ---> > - > -<struts-config> > + ]]> > + </description-long> > === message truncated === __________________________________ Do you Yahoo!? Yahoo! SiteBuilder - Free, easy-to-use web site design software http://sitebuilder.yahoo.com --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]