You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by cr...@apache.org on 2001/04/23 22:35:41 UTC
cvs commit: jakarta-struts/doc release-notes-1.0-b2.xml
craigmcc 01/04/23 13:35:41
Modified: . build-webapp.xml build.properties.sample build.xml
doc release-notes-1.0-b2.xml
Log:
Update the release notes for the next beta to include a list of the
files that are included in the binary distribution, and what to do
with them.
In addition, I'm starting a precedent to include other useful library
files in the "lib" directory. The first one is the JDBC 2.0 Optional
Package APIs (javax.sql), which you need to include in your webapp if it
is not provided by your servlet container.
Other libraries that are used to create Struts components in the future
will also be included (assuming that redistribution rights allow this)
to increase the usefulness of the Struts distribution.
Revision Changes Path
1.4 +2 -1 jakarta-struts/build-webapp.xml
Index: build-webapp.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/build-webapp.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- build-webapp.xml 2001/03/12 00:07:30 1.3
+++ build-webapp.xml 2001/04/23 20:35:33 1.4
@@ -140,6 +140,7 @@
<!-- The class path used for compiling this library -->
<path id="classpath">
+ <pathelement location="${jdbc20ext.jar}"/>
<pathelement location="${servlet.jar}"/>
<pathelement location="${struts.libs}/struts.jar"/>
<pathelement location="${webapp.libs}"/>
@@ -228,7 +229,7 @@
</copy>
<mkdir dir="${webapp.target}/WEB-INF/lib"/>
<copy todir="${webapp.target}/WEB-INF/lib">
- <fileset dir="${struts.libs}" includes="*.jar"/>
+ <fileset dir="${struts.libs}" includes="struts.jar"/>
</copy>
</target>
1.2 +6 -3 jakarta-struts/build.properties.sample
Index: build.properties.sample
===================================================================
RCS file: /home/cvs/jakarta-struts/build.properties.sample,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- build.properties.sample 2001/03/23 19:23:55 1.1
+++ build.properties.sample 2001/04/23 20:35:35 1.2
@@ -6,7 +6,7 @@
# to "build.properties" in the same directory that contains the Struts
# "build.xml" file.
#
-# $Id: build.properties.sample,v 1.1 2001/03/23 19:23:55 craigmcc Exp $
+# $Id: build.properties.sample,v 1.2 2001/04/23 20:35:35 craigmcc Exp $
# -----------------------------------------------------------------------------
# WARNING: The relative paths below assume that the build.xml file is in the
@@ -20,6 +20,11 @@
# if you are going to execute the "deploy.catalina" target.
catalina.home=../jakarta-tomcat-4.0/build
+# The JAR file containing the JDBC 2.0 Optional Package extensions API
+# (javax.sql). This file will automatically be added to your class path
+# when you compile Struts
+jdbc20ext.jar=../jdbc20/jdbc2_0-stdext.jar
+
# The directory containing your binary distribution of the Servlet API classes
# (CVS module "jakarta-servletapi" at jakarta.apache.org).
servletapi.home=../jakarta-servletapi
@@ -33,6 +38,4 @@
# from CVS module "xerces-j" at xml.apache.org. This is only required
# if you are going to execute the "deploy.catalina" target.
xerces.home=../xml-xerces
-
-
1.48 +19 -5 jakarta-struts/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/build.xml,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- build.xml 2001/04/20 00:43:16 1.47
+++ build.xml 2001/04/23 20:35:36 1.48
@@ -24,6 +24,9 @@
installation. This is required only when
executing the "deploy.catalina" target.
+ jdbc20ext.jar (required). The path to the JAR file
+ for the JDBC 2.0 Optional Package APIs.
+
servletapi.home (required). The path to the binary
distribution directory of your
servlet API distribution.
@@ -45,6 +48,7 @@
<!-- Default values for unspecified properties -->
<property name="catalina.home" value="../jakarta-tomcat-4.0/build"/>
+ <property name="jdbc20ext.jar" value="../jdbc2_0-stdext.jar"/>
<property name="servletapi.home" value="../jakarta-servletapi"/>
<property name="tomcat.home" value="../build/tomcat"/>
<property name="xerces.home" value="../xml-xerces"/>
@@ -55,9 +59,9 @@
<!--
These property values may optionally be overridden with property
- settings from an "ant" command line, the "antrc" properties file
- in your home directory, or from settings in a superior build.xml
- script.
+ settings from an "ant" command line, the "build.properties" file
+ in this directory, the "build.properties" file in your home
+ directory, or from settings in a superior build.xml script.
-->
<!-- Output directory name for all files generated by the build process -->
@@ -114,6 +118,13 @@
<!-- Location of the "servlet.jar" file to compile against -->
<property name="servlet.jar" value="${servletapi.home}/lib/servlet.jar"/>
+ <!-- Compilation Classpath -->
+ <path id="compile.classpath">
+ <pathelement location="${jdbc20ext.jar}"/>
+ <pathelement location="${servlet.jar}"/>
+ </path>
+
+
<!-- ========== Executable Targets ======================================== -->
@@ -144,6 +155,8 @@
<copy todir="${build.home}/library/classes/org/apache/struts/resources">
<fileset dir="${conf.share.dir}" includes="**/*.dtd"/>
</copy>
+ <copy file="${jdbc20ext.jar}"
+ tofile="${build.home}/library/jdbc2_0-stdext.jar"/>
</target>
<!--
@@ -160,10 +173,11 @@
description="Compile Struts library files">
<javac srcdir="${src.share.dir}"
destdir="${build.home}/library/classes"
- classpath="${servlet.jar}"
debug="${debug}"
optimize="${optimize}"
- deprecation="${deprecation}"/>
+ deprecation="${deprecation}">
+ <classpath refid="compile.classpath"/>
+ </javac>
<copy todir="${build.home}/library/classes">
<fileset dir="${src.share.dir}" includes="**/*.properties"/>
</copy>
1.4 +78 -0 jakarta-struts/doc/release-notes-1.0-b2.xml
Index: release-notes-1.0-b2.xml
===================================================================
RCS file: /home/cvs/jakarta-struts/doc/release-notes-1.0-b2.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- release-notes-1.0-b2.xml 2001/03/31 22:38:40 1.3
+++ release-notes-1.0-b2.xml 2001/04/23 20:35:40 1.4
@@ -21,6 +21,84 @@
</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>
+ <ul>
+ <li><code>INSTALL</code> - </li>
+ <li><code>LICENSE</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> - </li>
+ <li><code>etc/</code> - Directory containing the Ant build scripts
+ used to construct the Struts binary release. These are useful
+ as examples of how Ant can be used, but are not required to use
+ Struts in your own applications.</li>
+ <li><code>lib/</code> - Directory containing files you will need in
+ your own applications. The individual files of interest are:
+ <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
+ 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
+ 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>
+ <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
+ (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
+ copy is available for reference purposes only.</li>
+ <li><code>web-app_2_2.dtd</code> - The document type descriptor (DTD)
+ for web.xml files conforming to the Servlet 2.2 specification.
+ This copy is for reference purposes only.</li>
+ <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>src/</code> - Directory containing the Java source code for the
+ entire Struts framework, for reference purposes. <strong>NOTE</strong>
+ - if you wish to build Struts from scratch, you should download and
+ install the Struts Source Distribution instead of trying to build
+ from this directory.</li>
+ <li><code>webapps/</code> - Web Application Archive (WAR) files for the
+ web applications that are included with Struts.</li>
+ </ul>
+
+ <p>For backwards compatibility only, the binary distribution also
+ includes the following files that conform to the Struts 0.5 milestone
+ release APIs. Usage of these files and APIs is deprecated, and they
+ will be removed from releases after Struts 1.0:</p>
+ <ul>
+ <li><code>lib/</code> - Directory containing files you will need in
+ your own applications. The individual files of interest are:
+ <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
+ place this file in the <code>/WEB-INF/lib</code> directory of
+ your web application.</li>
+ <li><code>struts.tld</code> - The tag library descriptor file for
+ the 0.5 version of the Struts tags. You must place this file
+ in the <code>/WEB-INF</code> directory of your web application,
+ and reference it with appropriate <code><taglib></code>
+ directives in your web.xml file.</li>
+ </ul></li>
+ </ul>
+
+ </section>
+
+
<section name="What's New?" href="New">
<p><strong>DEPRECATIONS</strong> - The entire custom tag library