README_bin.txt

---------------------------------------------------------------------------
Apache Standard Tag Library 1.2.6 -- 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://jcp.org/en/jsr/detail?id=52 .

---------------------------------------------------------------------------
LIBRARY DEPENDENCIES

This version of the Standard Tag Library has the following runtime
dependencies:

   1. Dependencies provided by a JSP 2.1 container:
      - Java 1.5 or later
      - Servlet 2.5 or later
      - JSP 2.1 or later

   2. Additional dependencies
      - The XML tag library requires Apache Xalan 2.7.1 or later

---
Apache Xalan 2.7.1

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.5.jar
   - taglibs-standard-impl-1.2.5.jar
   - taglibs-standard-jstlel-1.2.5.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.5</version>
    </dependency>
    <dependency>
      <groupId>org.apache.taglibs</groupId>
      <artifactId>taglibs-standard-impl</artifactId>
      <version>1.2.5</version>
    </dependency>

---------------------------------------------------------------------------
USING JSTL TAGS FROM A JSP

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" %>

  XML LIBRARY
    <%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/xml" %>

  FMT LIBRARY 
    <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

  SQL LIBRARY
    <%@ taglib prefix="sql" uri="http://java.sun.com/jsp/jstl/sql" %>

  FUNCTIONS LIBRARY
    <%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>

---------------------------------------------------------------------------
COMPATIBILITY

The 1.2 version of the Standard Taglib has been tested using Tomcat 7.0.57
and should work in any compliant JSP 2.1 (or later) container.

In version 1.2.3 and later, the XML libraries enable FEATURE_SECURE_PROCESSING
when parsing and transforming. The system property

  org.apache.taglibs.standard.xml.accessExternalEntity

can be used to further restrict the protocols over which external entities can
be resolved. When a SecurityManager is enabled this will, by default, allow
access to no protocols. Permission must be granted to the taglibs-standard-impl
library to read this property.

  permission java.util.PropertyPermission "org.apache.taglibs.standard.xml.accessExternalEntity", "read";

---------------------------------------------------------------------------
COMMENTS AND QUESTIONS

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.

Enjoy!