You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by jb...@apache.org on 2013/11/10 22:25:11 UTC
svn commit: r1540554 - in /tomcat/taglibs/standard/trunk: NOTICE
README_bin.txt README_src.txt pom.xml
Author: jboynes
Date: Sun Nov 10 21:25:11 2013
New Revision: 1540554
URL: http://svn.apache.org/r1540554
Log:
address documentation comments
Modified:
tomcat/taglibs/standard/trunk/NOTICE
tomcat/taglibs/standard/trunk/README_bin.txt
tomcat/taglibs/standard/trunk/README_src.txt
tomcat/taglibs/standard/trunk/pom.xml
Modified: tomcat/taglibs/standard/trunk/NOTICE
URL: http://svn.apache.org/viewvc/tomcat/taglibs/standard/trunk/NOTICE?rev=1540554&r1=1540553&r2=1540554&view=diff
==============================================================================
--- tomcat/taglibs/standard/trunk/NOTICE (original)
+++ tomcat/taglibs/standard/trunk/NOTICE Sun Nov 10 21:25:11 2013
@@ -1,4 +1,4 @@
-Apache Tomcat Standard Taglib
+Apache Standard Taglib
Copyright 2001-2013 The Apache Software Foundation
This product includes software developed at
Modified: tomcat/taglibs/standard/trunk/README_bin.txt
URL: http://svn.apache.org/viewvc/tomcat/taglibs/standard/trunk/README_bin.txt?rev=1540554&r1=1540553&r2=1540554&view=diff
==============================================================================
--- tomcat/taglibs/standard/trunk/README_bin.txt (original)
+++ tomcat/taglibs/standard/trunk/README_bin.txt Sun Nov 10 21:25:11 2013
@@ -1,108 +1,74 @@
---------------------------------------------------------------------------
-Standard Tag Library 1.1 -- BINARY DISTRIBUTION
+Apache Standard Tag Library 1.2 -- BINARY DISTRIBUTION
---------------------------------------------------------------------------
Thanks for downloading this release of the Standard tag library,
an implementation of the JavaServer Pages(tm)(JSP)
Standard Tag Library (JSTL).
+This code is licensed to you by the Apache Software Foundation and its
+contributors under the terms of the Apache License V2.0;
+please see the included NOTICE and LICENSE files for details.
+
JSTL is an effort of the Java Community Process (JCP) and
comes out of the JSR-052 expert group. For more information on JSTL,
please go to http://java.sun.com/products/jstl.
-We hope you find the tags, documents, and examples in this binary
-distribution of interest.
-
---------------------------------------------------------------------------
LIBRARY DEPENDENCIES
This version of the Standard Tag Library has the following runtime
dependencies:
- 1. Dependencies provided by the JSP 2.0 container:
- - Servlet 2.4
- - JSP 2.0
-
- 2. Dependencies provided in newer J2SEs (1.4.2 and higher)
- - JAXP 1.2
- - Xalan 2.5
- - JDBC Standard Extension 2.0
-
-Since all of the dependencies in (2) are included in Sun's
-distribution of J2SE 1.4.2 (and higher), this is therefore the J2SE
-version of choice to use the standard tag library.
-
-If the java platform under which you run your JSP container does not
-provide these dependencies, they must be made available either globally
-to all web-applications by your container, or individually within the
-WEB-INF/lib directory of your web-application.
-
-For convenience, these jar files have been included in directory
-lib/old-dependencies of this distribution (assuming the build process
-of this distribution included them). If you would like to download
-these jar files yourself, instructions on where you can get them are
-included below.
-
----
-JAXP 1.2
-
-The JAXP 1.2 jar files can be obtained in the Java Web Services
-Developer Pack (JWSDP) available at
-http://java.sun.com/products/jwsdp.
-
- - jaxp-api.jar
- - dom.jar
- - sax.jar
- - xercesImpl.jar
-
----
-Xalan 2.5
+ 1. Dependencies provided by a JSP 2.0 container:
+ - Java 1.5 or later
+ - Servlet 2.4 or later
+ - JSP 2.0 or later
-The Xalan jar file can be obtained in the Java Web Services
-Developer Pack (JWSDP) available at
-http://java.sun.com/products/jwsdp, as well as from
-Apache at http://xml.apache.org/xalan-j.
-
- - xalan.jar
-
-Please note that if you use Sun's distribution of J2SE 1.4.1, you must
-supersede the version of xalan.jar provided by the J2SE with version
-2.5 or higher of Xalan. This newer version of xalan.jar must then be
-made available through the endorsed dirs mechanism.
+ 2. Additional dependencies
+ - The XML tag library requires Apache Xalan 2.7.1 or later
---
-JDBC Standard Extension 2.0
-
-The JDBC 2.0 Optional Package can be obtained from:
-http://java.sun.com/products/jdbc/download.html
-
- - jdbc2_0-stdext.jar
-
----------------------------------------------------------------------------
-WAR Files
-
-The following two files are standalone web applications (WARs) that are
-designed to work out of the box in order to help you learn JSTL:
-
- standard-doc.war Documentation
- standard-examples.war Simple examples of JSTL tags
-
-Note that 'standard-examples.war' will work out-of-the-box as long
-as the java platform under which you run your JSP container provides
-all the dependencies mentioned above (see Library Dependencies).
-This is the case if using Sun's distribution of J2SE 1.4.2 (and higher).
+Apache Xalan 2.7.1
-If not all dependencies are provided by your runtime, then they must
-be made available to the web application as explained in section
-"Library Dependencies".
+To address performance issues with XSLT processing, this version relies on
+implementation specific functionality from Apache Xalan. The following
+libraries should be included in the classpath for your application:
+ - xalan-2.7.1.jar
+ - serializer-2.7.1.jar
+
+---------------------------------------------------------------------------
+ADD DEPENDENCIES TO A WEB APPLICATION
+
+To use this distribution with your own web applications, add the following JAR
+files to the '/WEB-INF/lib' directory of your application:
+ - taglibs-standard-spec-1.2.0.jar
+ - taglibs-standard-impl-1.2.0.jar
+ - taglibs-standard-jstlel-1.2.0.jar
+ - xalan-2.7.1.jar
+ - serializer-2.7.1.jar
+
+If you do not use JSTL 1.0 tags then the "taglibs-standard-jstlel" JAR may be
+omitted. If you do not use the XML library, then the Apache Xalan dependencies
+may also be omitted.
+
+If you build you application with Maven, add the following dependencies to
+your pom.xml file:
+
+ <dependency>
+ <groupId>org.apache.taglibs</groupId>
+ <artifactId>taglibs-standard-spec</artifactId>
+ <version>1.2.0</version>
+ </dependency>
+ <dependency>
+ <groupId>org.apache.taglibs</groupId>
+ <artifactId>taglibs-standard-impl</artifactId>
+ <version>1.2.0</version>
+ </dependency>
---------------------------------------------------------------------------
-USING THE STANDARD TAG LIBRARY
+USING JSTL TAGS FROM A JSP
-To use this distribution with your own web applications, simply copy the JAR
-files in the 'lib' directory (jstl.jar and standard.jar) to your application's
-WEB-INF/lib directory (add the other dependencies as well if your runtime
-does not already provide them). Then, import JSTL into your pages with the
-following directives:
+The JSTL tag library can be imported into your pages with the following directives:
CORE LIBRARY
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
@@ -122,14 +88,14 @@ following directives:
---------------------------------------------------------------------------
COMPATIBILITY
-The 1.1 version of the Standard Taglib has been tested under Tomcat 5.0.3
-and should work in any compliant JSP 2.0 container.
+The 1.2 version of the Standard Taglib has been tested under Tomcat 7.0.47
+and should work in any compliant JSP 2.0 (or later) container.
---------------------------------------------------------------------------
COMMENTS AND QUESTIONS
-Please join the taglibs-user@jakarta.apache.org mailing list if you have
-general usage questions about JSTL.
+Please join the taglibs-user@tomcat.apache.org mailing list if you have
+general usage questions about Apache Taglibs.
Comments about the JSTL specification itself should be sent to
jsr-52-comments@jcp.org.
Modified: tomcat/taglibs/standard/trunk/README_src.txt
URL: http://svn.apache.org/viewvc/tomcat/taglibs/standard/trunk/README_src.txt?rev=1540554&r1=1540553&r2=1540554&view=diff
==============================================================================
--- tomcat/taglibs/standard/trunk/README_src.txt (original)
+++ tomcat/taglibs/standard/trunk/README_src.txt Sun Nov 10 21:25:11 2013
@@ -5,13 +5,13 @@ Thanks for downloading the source code f
implementation of the JavaServer Pages(tm)(JSP) Standard Tag Library (JSTL)
specification. This code is licensed to you by the Apache Software
Foundation and its contributors under the terms of the Apache License V2.0;
-please see the included NOTICE.txt and LICENSE.txt files for details.
+please see the included NOTICE and LICENSE files for details.
---------------------------------------------------------------------------
BUILD ENVIRONMENT SETUP
For the 1.2 release, the project migrated to the Apache Maven build system.
-Download and install version 2.2 or higher from http://maven.apache.org
+Download and install version 3.0 or higher from http://maven.apache.org
The build requires a Java Development Kit Version 5 or higher.
@@ -23,7 +23,6 @@ normal Maven goals:
$ mvn install <-- builds all targets and installs in local repository
$ mvn clean <-- removes all build artifacts
- $ mvn release <-- builds all targets and releases to staging repo
A typical build will use the 'install' goal that compiles all classes, runs
all the unit tests, creates the target bundles, and installs them in the
@@ -35,10 +34,13 @@ repositories. You should be online when
Information about the project can be found in the 'pom.xml' project
descriptor.
+For information about performing a release at Apache, please refer to
+"Publishing Maven Artifacts" at http://www.apache.org/dev/publishing-maven-artifacts.html
+
---------------------------------------------------------------------------
PROJECT MODULES
-There are four sub-modules:
+There are three primary sub-modules:
spec <-- contains Apache's implementation of the API classes
impl <-- contains the implementation of tags from the 1.1
@@ -46,6 +48,9 @@ There are four sub-modules:
jstlel <-- contains the implementation of tags from the 1.0
namespace http://java.sun.com/jstl/* and uses the
original JSTL 1.0 version of EL
+
+In addition, the following modules provide supporting functionality
+ build-tools <-- build support such as checkstyle rules
compat <-- contains the implementation of tags from the 1.0
- namespace but uses the JSP container implementation
+ namespace but uses the JSP container's implementation
of EL (which will be 2.1 or later).
Modified: tomcat/taglibs/standard/trunk/pom.xml
URL: http://svn.apache.org/viewvc/tomcat/taglibs/standard/trunk/pom.xml?rev=1540554&r1=1540553&r2=1540554&view=diff
==============================================================================
--- tomcat/taglibs/standard/trunk/pom.xml (original)
+++ tomcat/taglibs/standard/trunk/pom.xml Sun Nov 10 21:25:11 2013
@@ -45,14 +45,6 @@
<url>http://svn.apache.org/viewvc/tomcat/taglibs/standard/trunk</url>
</scm>
- <distributionManagement>
- <site>
- <id>apache.website</id>
- <name>Apache Website</name>
- <url>scpexe://people.apache.org/www/tomcat.apache.org/taglibs/standard-${project.version}/</url>
- </site>
- </distributionManagement>
-
<ciManagement>
<system>jenkins</system>
<url>https://builds.apache.org/job/taglib-standard/</url>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org