grchiu 2003/06/17 13:16:57
Modified: java/xdocs/sources/xalan commandline.xml samples.xml
trax.xml usagepatterns.xml
Log:
Patch contributed by Glen Mazza ([EMAIL PROTECTED]) for bugzilla 20625:
Fixing some documentation typos.
Revision Changes Path
1.27 +1 -1 xml-xalan/java/xdocs/sources/xalan/commandline.xml
Index: commandline.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/commandline.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- commandline.xml 10 Apr 2003 14:34:58 -0000 1.26
+++ commandline.xml 17 Jun 2003 20:16:57 -0000 1.27
@@ -150,6 +150,6 @@
<jump href="apidocs/org/xml/sax/EntityResolver.html">EntityResolver</jump>
SAX interface to handle external entity references.</p>
<p>Use <code>-CONTENTHANDLER</code> with a fully qualified class name to
utilize a custom implementation of the
<jump href="apidocs/org/xml/sax/ContentHandler.html">ContentHandler</jump>
SAX interface to serialize output.</p>
- <note>If you want to validate an XML document (verify that it adheres to its
DOCTYPE declatation), you can use the <link idref="samples"
anchor="validateutility">Validate utility</link> shipped with &xslt4j-current;.</note>
+ <note>If you want to validate an XML document (verify that it adheres to its
DOCTYPE declaration), you can use the <link idref="samples"
anchor="validateutility">Validate utility</link> shipped with &xslt4j-current;.</note>
</s2>
</s1>
1.57 +11 -11 xml-xalan/java/xdocs/sources/xalan/samples.xml
Index: samples.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/samples.xml,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -r1.56 -r1.57
--- samples.xml 7 Jun 2003 21:12:15 -0000 1.56
+++ samples.xml 17 Jun 2003 20:16:57 -0000 1.57
@@ -159,7 +159,7 @@
<p>where <ref>param</ref> is the stylesheet parameter value (a string of your
choice).</p>
</s2><anchor name="sax2sax"/>
<s2 title="SAX2SAX">
- <p>What it does: Explicitly set the SAX XMLReader and SAX ContentHandler for
processing the stylesheet (birds.xsl), processing the XML input (birds.xml), and
producing the output (birds.out).</p>
+ <p>What it does: Explicitly sets the SAX XMLReader and SAX ContentHandler for
processing the stylesheet (birds.xsl), processing the XML input (birds.xml), and
producing the output (birds.out).</p>
<p>Run this sample from the SAX2SAX subdirectory with</p>
<p><code>java SAX2SAX</code></p>
</s2><anchor name="dom2dom"/>
@@ -228,7 +228,7 @@
<p>For more information, see <link idref="usagepatterns" anchor="xpath">Working
with XPath expressions</link>.</p>
</s2><anchor name="appletxmltohtml"/>
<s2 title="AppletXMLtoHTML">
- <p>The applet uses a stylesheet to transform an XML document into HTML. It
displays the XML document, the
+ <p>This applet uses a stylesheet to transform an XML document into HTML. It
displays the XML document, the
stylesheet, and the HTML output.</p>
<p>How to run it: Open appletXMLtoHTML.hmtl in the Internet Explorer 5
browser.</p>
<note>For information about running &xslt4j; applets in Netscape Communicator,
see <link idref="usagepatterns" anchor="netscape">Problems
@@ -242,8 +242,8 @@
<p>The servlet subdirectory contains four sample servlets and one JSP that use
&xslt4j; to perform transformations. The sample
code is compiled and packed in xalanservlet.war. To run these samples, you must
place
xalanservlet.war on a web server with a servlet engine. For example, using
<jump href="http://jakarta.apache.org/tomcat/index.html";>jakarta-tomcat 4.1.18</jump>.
- Copy the xalanservlet.war to %Tomcat_Home%/webapps. For more detail about
deploying
- servlet on Tomcat, please refer to <jump
href="http://jakarta.apache.org/tomcat/tomcat-4.1-doc/appdev/deployment.html";>Deployment
Organization</jump>.</p>
+ Copy the xalanservlet.war to %Tomcat_Home%/webapps. For more details about
deploying
+ servlets on Tomcat, please refer to <jump
href="http://jakarta.apache.org/tomcat/tomcat-4.1-doc/appdev/deployment.html";>Deployment
Organization</jump>.</p>
<note>Dependency on Tomcat version. If encountering "java.lang.VerifyError:
Cannot inherit from final class" error,
replace xercesImpl.jar under %Tomcat_Home%/common/endorsed with the one
included with &xslt4j; .</note>
<p><link anchor="simplexsltservlet">servlet.SimpleXSLTServlet</link> applies a
particular stylesheet to a particular
@@ -269,10 +269,10 @@
<s3 title="servlet.UseStylesheetParamServlet">
<note>Paul Campbell <[EMAIL PROTECTED]> wrote this servlet and the
following explanatory text.
Thank you, Paul!</note>
- <p>What it does: The client (perhaps an HTML form ) specifies an XML document,
a stylesheet, and a value to be passed
+ <p>What it does: The client (perhaps an HTML form) specifies an XML document,
a stylesheet, and a value to be passed
to the stylesheet for a stylesheet parameter named "param1". The servlet
performs the transformation and returns
the output to the client. The client must specify which stylesheet
(containing a "param1" stylesheet parameter")
- and XML file are to be used or use sample files fooparam.xml and
fooparam.xsl</p>
+ and XML file are to be used or use sample files fooparam.xml and
fooparam.xsl.</p>
<p>How to run it: set up an HTML client to call the servlet with arguments
along the lines of</p>
<gloss><label>http://localhost:port/xalanservlet/UseStylesheetParamServlet?
XML=fooparam.xml&XSL=fooparam.xsl&PVAL=GoodBye</label></gloss>
@@ -318,8 +318,8 @@
<p>To run the servlet: set system property server.root=server root. Set up an
HTML page to call
servlet.ApplyXSLT with arguments as illustrated below.</p>
<p>The files catalog.xml, booklist1.xsl and booklist2.xsl are used in the
following example.
- In the deploy descriptor, booklist1.xsl is set as the default xsl file. If you
create these files yourself, be careful that the output method should
- be set to "xml" in the stylesheet.</p>
+ In the deployment descriptor, booklist1.xsl is set as the default xsl file. If
you create these files yourself, make sure that you set the output method
+ to "xml" in the stylesheet.</p>
<p>Examples:</p>
<gloss>
<label>http://localhost:port/xalanservlet/ApplyXSLT?URL=/xalanservlet/catalog.xml&xslURL=
@@ -489,7 +489,7 @@
</s3><anchor name="pquery"/>
<s3 title="Parameterized query">
<p><em>Contributed by John Gentilin ([EMAIL PROTECTED]).</em></p>
- <p>What it does: connect to a datasource, execute a parameterized query, and
return the result. The XML source document
+ <p>What it does: connects to a datasource, executes a parameterized query, and
returns the result. The XML source document
provides the parameter value as well as the connection information. The
parameter value is in a node in the XML source.</p>
<p>The stylesheet gets the required connection and parameter information from
the XML source, sets up and executes the
parameterized query, and retuns the query result set.</p>
@@ -505,7 +505,7 @@
<p>1. To turn caching on:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
<br/><code>-xsl cachedNodes.xsl</code></p>
- <p>1. To turn caching off:</p>
+ <p>2. To turn caching off:</p>
<p><code>java org.apache.xalan.xslt.Process</code>
<br/><code>-xsl streamNodes.xsl</code></p>
<p>3. <ref>To be added</ref></p>
@@ -562,7 +562,7 @@
</s2>
<anchor name="trax"/>
<s2 title="trax">
- <p>What it does: run a number of samples illustrating uses of the <link
idref="trax">TrAX (Transformation API for XML)</link> interfaces.</p>
+ <p>What it does: runs a number of samples illustrating uses of the <link
idref="trax">TrAX (Transformation API for XML)</link> interfaces.</p>
<p>Run this sample from the trax subdirectory with</p>
<p><code>java Examples</code></p>
<p>and examine the source in Examples.java and ExampleContentHandler.java.</p>
1.6 +1 -1 xml-xalan/java/xdocs/sources/xalan/trax.xml
Index: trax.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/trax.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- trax.xml 7 Jun 2003 21:12:15 -0000 1.5
+++ trax.xml 17 Jun 2003 20:16:57 -0000 1.6
@@ -125,7 +125,7 @@
<label>Identity (or Copy) Transformation</label>
<item>The process of transformation from a source to a result,
making as few structural changes as possible and no
informational changes. The
- term is somewhat loosely used, as the process is really a
copy. from one
+ term is somewhat loosely used, as the process is really a
copy from one
"format" (such as a DOM tree, stream, or set of SAX events) to
another.</item>
1.58 +3 -3 xml-xalan/java/xdocs/sources/xalan/usagepatterns.xml
Index: usagepatterns.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/usagepatterns.xml,v
retrieving revision 1.57
retrieving revision 1.58
diff -u -r1.57 -r1.58
--- usagepatterns.xml 7 Jun 2003 21:12:15 -0000 1.57
+++ usagepatterns.xml 17 Jun 2003 20:16:57 -0000 1.58
@@ -250,7 +250,7 @@
<p>An XML Source may include an <jump
href="http://www.w3.org/TR/xml-stylesheet/";>xml-stylesheet processing
instruction</jump> which identifies the stylesheet to be used to process the document.
As indicated by the processing instruction <ref>href</ref> attribute, the stylesheet
itself may be embedded in the XML document or located elsewhere.</p>
<p>Suppose you have an XML document (foo.xml) with the following xml-stylesheet
processing instruction:</p>
<p><code><?xml-stylesheet type="text/xml" href="foo.xsl"?></code></p>
-<p>The following fragment, uses this instruction to locate the stylesheet (foo.xsl
in the same directory as foo.xml) and create a Templates object. Note the use of the
TransformerFactory getAssociatedStylesheet() in step 2a.</p>
+<p>The following fragment uses this instruction to locate the stylesheet (foo.xsl
in the same directory as foo.xml) and create a Templates object. Note the use of the
TransformerFactory getAssociatedStylesheet() in step 2a.</p>
<note>An XML document may include more than one xml-stylesheet processing
instruction, hence the support for working with multiple stylesheets. If more than one
stylesheet is returned, the other stylesheets are imported into the first
stylesheet.</note>
<source>// 1. Instantiate the TransformerFactory.
javax.xml.transform.TransformerFactory tFactory =
@@ -258,7 +258,7 @@
// 2a. Get the stylesheet from the XML source.
String media = null , title = null, charset = null;
javax.xml.transform.Source stylesheet = tFactory.getAssociatedStylesheet
- (new StreamSource("foo.xml"),media, title, charset);
+ (new StreamSource("foo.xml"), media, title, charset);
// 2b. Process the stylesheet and generate a Transformer.
Transformer transformer = tFactory.newTransformer(stylesheet);
@@ -291,7 +291,7 @@
<s2 title="Explicitly working with SAX">
<p>&xslt4j; uses the SAX event model to process stylesheets, to parse XML input
documents, and to produce output. For each of these operations, an XMLReader reads
input, firing parse events, and a ContentHandler listens to the XMLReader and executes
parse event methods.</p>
<p>When you use the basic procedure described above for performing transformations,
&xslt4j; takes care of many of the SAX details under the covers. You are free to make
these details explicit, which simply means that you can intervene in the procedure to
accommodate the precise environment in which your application operates.</p>
-<p>Suppose, for example, you are using a custom XMLReader, perhaps doing more than
just parsing static XML documents) to generate &xslt4j; SAX parse events. You might
even have a custom reader for producing/processing stylesheets. You can cast the
TransformerFactory to a SAXTransformerFactory, which provides access to a
TransformerHandler, which you can set as the ContentHandler for this reader.</p>
+<p>Suppose, for example, you are using a custom XMLReader (perhaps for doing more
than just parsing static XML documents) to generate &xslt4j; SAX parse events. You
might even have a custom reader for producing/processing stylesheets. You can cast the
TransformerFactory to a SAXTransformerFactory, which provides access to a
TransformerHandler, which you can set as the ContentHandler for this reader.</p>
<p>The following example explicitly sets up the XMLReader and ContentHandlers,
and replicates the <link anchor="basic">basic steps</link> described above.</p>
<source>// Instantiate a TransformerFactory.
javax.xml.transform.TransformerFactory tFactory =
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
