santiagopg 02/05/17 14:08:24
Modified: java/xdocs/sources/xalan xsltc_usage.xml
Log:
Updated first three sections.
Revision Changes Path
1.29 +23 -27 xml-xalan/java/xdocs/sources/xalan/xsltc_usage.xml
Index: xsltc_usage.xml
===================================================================
RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan/xsltc_usage.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- xsltc_usage.xml 17 May 2002 17:36:16 -0000 1.28
+++ xsltc_usage.xml 17 May 2002 21:08:24 -0000 1.29
@@ -71,14 +71,17 @@
<p>See also: <jump href="xsltc/index.html">XSLTC Design</jump></p>
<anchor name="intro"/>
<s2 title="Introduction">
-<p>XSLTC provides a compiler and a runtime processor. Use the compiler to
compile an XSL stylesheet into a translet, a set of Java classes. Use the
runtime processor to apply the translet to an XML document and perform a
transformation.</p>
-<note>To compile translets, you must be running the JDK or JRE 1.2 or
higher. You can run translets with the JDK or JRE 1.1.8 or higher.</note>
+<p>XSLTC provides a compiler and a runtime processor.
+Use the compiler to compile an XSL stylesheet into a translet (i.e. a set of
Java
+classes). Use the runtime processor to apply the translet to an XML document
and
+perform a transformation.</p>
+<note>To compile and run translets you must have a JDK or a JRE 1.2 or
higher.</note>
</s2><anchor name="classpath"/>
<s2 title="Setting the system classpath for XSLTC">
<p>
The jar file structure of the XSLTC component has changed. In the original
-structure the xsltc.jar file contained only the XSLTC classes, and the
+structure the xsltc.jar file contained only XSLTC classes, and the
other support jar files needed to be in the user's class path.
If you want to use this model refer to the subsection below
'Unbundled System Classpath'. In the newer model, all of the support
@@ -94,8 +97,12 @@
To use this newer approach, simply put xsltc.jar in your classpath.
No need to mention the others (BCEL.jar, JLex.jar, regexp.jar, java_cup.jar,
runtime.jar).
-<note>Be sure to also a JAXP XML parser, such as xercesImpl.jar and
xml-apis.jar, which are in our distribution.</note>
</p>
+<note>In order to compile and run translets you must have a JAXP-compliant
XML parser
+installed. Our distribution
+includes<jump href="http://xml.apache.org/xerces2-j/index.html";>Xerces</jump>
+(just include xercesImpl.jar and xml-apis.jar in your class path).
+</note>
</s3>
<s3 title="Unbundled System Classpath">
@@ -105,54 +112,46 @@
<th>Classes or JAR</th>
<th>To compile a translet</th>
<th>To run a translet</th>
- <th>To use the XSLTC API</th>
</tr>
<tr>
<td>the translet</td>
<td></td>
<td>required</td>
- <td>required</td>
</tr>
<tr>
<td>xsltc.jar</td>
<td>required</td>
<td>required</td>
- <td>required</td>
</tr>
<tr>
<td>runtime.jar</td>
<td>required</td>
- <td></td>
- <td>required</td>
+ <td>required</td>
</tr>
<tr>
<td>BCEL.jar</td>
<td>required</td>
<td></td>
- <td>required</td>
</tr>
<tr>
<td>JLex.jar</td>
+ <td>required</td>
<td></td>
- <td></td>
- <td>required</td>
</tr>
<tr>
<td>java_cup.jar</td>
+ <td>required</td>
<td></td>
- <td></td>
- <td>required</td>
</tr>
<tr>
<td>regexp.jar</td>
<td>required</td>
<td></td>
- <td>required</td>
</tr>
</table>
-<p>The JAR files listed above are in the &xslt4j; bin directory. The
translet is the set of class files or the JAR file that you generate with the
compiler; see <link anchor="compile">Compiling translets</link>.</p>
-<p>If you are using JDK or JRE 1.1.8, also include classes.zip on the
classpath. If you are using JDK or JRE 1.2, include tools.jar on the
classpath.</p>
-<note>For the time being, the Xalan processor and XSLT do not yet use the
same DOM, SAX, and parser infastructures. Accordingly, you may find it
necessary to reset the system classpath each time you switch between the Xalan
processor and XSLTC. For information on setting the classpath for the Xalan
processor, see <link idref="getstarted" anchor="classpath">Setting the system
classpath for Xalan</link>.</note>
+<p>The JAR files listed above are installed in the &xslt4j; bin directory.
+The translet is the set of class files or the JAR file that you generate
with the
+compiler; see <link anchor="compile">Compiling translets</link>.</p>
</s3>
<anchor name="compile"/>
<s2 title="Compiling translets from the command line">
@@ -165,21 +164,18 @@
stylesheets into lightweight and portable Java byte codes
called translets.</p>
- <p>The XSLT Compiler can be run on any platform including UNIX,
- Windows, NT, or Mac that supports Java 1.2.x or later. The generated
- translets can be run on any platform that supports a Java
- Runtime Environment, including a Palm Pilot with J2ME CLDC
- (Java 2 Micro Edition, Connected Limited Device Configuration).</p>
-
- <p>To run the compiler from the command line or a script, <link
anchor="classpath">set the classpath</link> and
- run the XSLTC class with the appropriate flags and arguments (described
below).</p>
+ <p>To run the compiler from the command line or from a script,
+ <link anchor="classpath">set the classpath</link> and
+ run the class org.apache.xalan.xsltc.cmdline.Compile. The synopsis
+ of the options and arguments accepted by this class is shown below.
+ </p>
<anchor name="comp-synopsis"/>
<s3 title="Synopsis">
<p>
<code>java org.apache.xalan.xsltc.cmdline.Compile</code><br/>
<code> [-o <output>] [-d <directory>] [-j
<jarfile>]</code><br/>
<code> [-p <package name>] [-n] [-x] [-v] [-u]
[-h]<br/>
-{<stylesheet> | -i }</code></p>
+ {<stylesheet> | -i }</code></p>
</s3><anchor name="comp-args"/>
<s3 title="Flags and arguments">
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
