You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by dl...@apache.org on 2001/12/20 23:12:30 UTC
cvs commit: xml-xalan/c/xdocs/sources/xalan commandline.xml faq.xml getstarted.xml index.xml readme.xml samples.xml usagepatterns.xml
dleslie 01/12/20 14:12:30
Modified: c/xdocs/sources/xalan commandline.xml faq.xml getstarted.xml
index.xml readme.xml samples.xml usagepatterns.xml
Log:
More updates for release 1.3.
Revision Changes Path
1.22 +3 -3 xml-xalan/c/xdocs/sources/xalan/commandline.xml
Index: commandline.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/commandline.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- commandline.xml 2001/12/20 13:57:15 1.21
+++ commandline.xml 2001/12/20 22:12:29 1.22
@@ -63,7 +63,7 @@
<ul>
<li><link anchor="use">Using a command-line utility</link></li>
<li><link anchor="xalanexe">Using the Xalan executable</link></li>
-<li><link anchor="testXSLT">Using TestXSLT</link></li>
+<li><link anchor="testxslt">Using TestXSLT</link></li>
<li><link anchor="icu">Enabling ICU support for the Xalan executable and/or testXSLT</link></li>
</ul><anchor name="use"/>
<s2 title="Using a command-line utility">
@@ -159,9 +159,9 @@
<li>Build Xalan.exe and/or TestXSLT.exe.</li>
</ol>
</s3>
- <s3 title="Rebuilding testXSLT in UNIX">
+ <s3 title="Rebuilding Xalan and/or testXSLT in UNIX">
<p>In the Linux, AIX, HP-UX 11, and Solaris builds &solarisbuild;, the ICUBridge is in the core Xalan library (&xslt4c-linuxlib; in Linux; &xslt4c-aixlib; in
- AIX; &xslt4c-hplib; in HP-UX 11; &xslt4c-solarislib; lib; in Solaris ), so you must rebuild this library along with Xalan and/or testXSLT.</p>
+ AIX; &xslt4c-hplib; in HP-UX 11; &xslt4c-solarislib; in Solaris ), so you must rebuild this library along with Xalan and/or testXSLT.</p>
<p>Before you do the build, define the XALAN_USE_ICU environment variable. For information about defining this
environment variable and doing a build, see <link idref="readme" anchor="unix">Steps for doing a
UNIX build</link>.</p>
1.26 +2 -2 xml-xalan/c/xdocs/sources/xalan/faq.xml
Index: faq.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/faq.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- faq.xml 2001/12/20 13:57:15 1.25
+++ faq.xml 2001/12/20 22:12:29 1.26
@@ -62,12 +62,12 @@
</tr>
<tr>
<td>AIX 4.3</td>
- <td>IBM C and C++ for AIX 3.6.6</td>
+ <td>IBM C and C++ for AIX 5.02</td>
<td>Yes</td>
</tr>
<tr>
<td>Solaris 2.6 &solarisbuild;</td>
- <td>Workshop 4.2</td>
+ <td>[Workshop 4.2]</td>
<td>Yes</td>
</tr>
<tr>
1.29 +4 -4 xml-xalan/c/xdocs/sources/xalan/getstarted.xml
Index: getstarted.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/getstarted.xml,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- getstarted.xml 2001/12/20 13:57:15 1.28
+++ getstarted.xml 2001/12/20 22:12:29 1.29
@@ -22,9 +22,9 @@
<p><img src="xalan-c-unixdist.gif" alt="xalan-cdist.gif"/></p>
</s3>
<p>For the Linux build, download <resource-ref idref="xslt4c-linux-download"/>. This Red Hat Linux 6.1 distribution was built with egcs-2.91.66 and glibc-2.1.2-11.</p>
-<p>For the AIX build, download <resource-ref idref="xslt4c-aix-download"/>. This AIX 4.3 distribution was built with IBM C and C++ for AIX 3.6.6.</p>
+<p>For the AIX build, download <resource-ref idref="xslt4c-aix-download"/>. This AIX 4.3 distribution was built with IBM C and C++ for AIX 5.02.</p>
<p>For the HP-UX 11 build, download <resource-ref idref="xslt4c-hp-ux-download"/>. This HP-UX 11 distribution was built with aCC A.03.27.</p>
-<p>For the Solaris build, download <resource-ref idref="xslt4c-Solaris-download"/>. This Solaris distribution was built with Workshop 4.2.</p>
+<p>For the Solaris build, download <resource-ref idref="xslt4c-Solaris-download"/>.[This Solaris distribution was built with Workshop 4.2.]</p>
<note>Use GNU tar to untar the Solaris distribution file; see <link idref="faq" anchor="gnutar">A tar checksum error on Solaris </link>.</note>
<p>Each distribution contains all you need to run the Xalan command-line transformations utility and to build your own applications.
If you want to take advantage of the support for number formatting, sorting, and encoding the ICU provides, you should also download and install the <resource-ref idref="icu"/>; see <link idref="usagepatterns" anchor="icu">Using the ICU</link>,</p>
@@ -61,7 +61,7 @@
<li>The Xalan-C++ shared library: &xslt4c-solarislib;</li>
<li>The Xerces-C++ shared library: &xml4c-solarislib;</li>
</ul>
-<p>If you want to enable ICU support for the command-line utility, you must build the ICU and rebuild the Xalan-C++ shared/load library (Linux/AIX/HP-UX 11) and TestXSLT (all platforms) with the ICUBridge. See <link idref="usagepatterns" anchor="icu">Using the ICU</link> and <link idref="commandline" anchor="icu">Enabling ICU support for TestXSLT</link>.</p>
+<p>If you want to enable ICU support for the command-line utility, you must build the ICU and rebuild the Xalan-C++ shared/load library (Linux/AIX/HP-UX 11) and Xalan or TestXSLT (all platforms) with the ICUBridge. See <link idref="usagepatterns" anchor="icu">Using the ICU</link> and <link idref="commandline" anchor="icu">Enabling ICU support for the Xalan and/or TestXSLT executable</link>.</p>
<p>For information about using the command-line utility, see <link idref="commandline">Command-Line Utility</link>.</p>
<note>If you want to do your own AIX or Solaris build, you must download <resource-ref idref="stlport"/> and set the STLPORTROOT
environment variable to the complete path to the STLPort distribution (see the <link idref="readme" anchor="build">Build notes</link>)</note>
@@ -104,7 +104,7 @@
<p>For more information about the samples, see <link idref="samples">&xslt4c; Samples</link>.</p>
</s2><anchor name="commandline"/>
<s2 title="Performing your own transformations from the command line">
-<p>TestXSLT provides a basic utility for performing transformations from the command line. The command line for
+<p>The Xalan executable lets you perform transformations from the command line. The command line for
most standard transformations is as follows:</p>
<p><code>Xalan -o <ref>outputfile</ref> <ref>xmlSource</ref> <ref>stylesheet</ref></code></p>
<p>where <ref>xmlSource</ref> is the XML source file name, <ref>stylesheet</ref> is the XSL stylesheet file name, and <ref>outputfile</ref> is the output file name.</p>
1.26 +3 -3 xml-xalan/c/xdocs/sources/xalan/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/index.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- index.xml 2001/12/20 13:57:15 1.25
+++ index.xml 2001/12/20 22:12:29 1.26
@@ -92,7 +92,7 @@
<tr>
<td>AIX 4.3</td>
<td><resource-ref idref="xslt4c-aix-download"/></td>
- <td>IBM C and C++ for AIX 3.6.6</td>
+ <td>IBM C and C++ for AIX 5.02</td>
</tr>
<tr>
<td>HP-UX 11</td>
@@ -102,8 +102,8 @@
<tr>
<td>Solaris 2.6</td>
<td><resource-ref idref="xslt4c-Solaris-download"/>*<br/>
- *Use GNU tar to untar; see <link idref="faq" anchor="gnutar">FAQs</link></td>
- <td>Workshop 4.2</td>
+ [*Use GNU tar to untar; see <link idref="faq" anchor="gnutar">FAQs</link>]</td>
+ <td>[Workshop 4.2]</td>
</tr>
</table>
<p>Volunteers are more than welcome to help develop builds for other platforms!</p>
1.32 +6 -6 xml-xalan/c/xdocs/sources/xalan/readme.xml
Index: readme.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/readme.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- readme.xml 2001/12/20 13:57:15 1.31
+++ readme.xml 2001/12/20 22:12:29 1.32
@@ -71,7 +71,7 @@
<anchor name="status"/>
<s2 title="Status">
<ul>
- <li><link anchor="done">Changes since &xslt4c; version 1.1</link></li>
+ <li><link anchor="done">Changes since &xslt4c; version 1.2</link></li>
<li><link anchor="bugs">Bug reporting</link></li>
<li><link anchor="xml4c">Version of &xml4c; to use</link></li>
<li><link anchor="to-do">To-do tasks for future &xslt4c; releases</link></li>
@@ -143,10 +143,10 @@
<li>(Optional) If you are rebuilding the ICUBridge, install the ICU so the icu root directory
is at the same level as the xml-xerces root directory (see <link
idref="usagepatterns" anchor="icu">Using the ICU</link>.<br/><br/>
- If you want TestXSLT to use ICU support for number formatting and sorting, install the ICU,
+ If you want the Xalan and/or testXSLT executable to use ICU support for number formatting and sorting, install the ICU,
uncomment the <code>#define XALAN_USE_ICU</code> statement in process.cpp, and use the Visual C++
- Project Dependencies command to add ICUBridge to the list of TestXSLT dependencies (see <link idref="commandline"
- anchor="icu">Enabling ICU support for TestXSLT</link>).<br/><br/></li>
+ Project Dependencies command to add ICUBridge to the list of XalanTransformer and/or TestXSLT dependencies (see <link idref="commandline"
+ anchor="icu">Enabling ICU support for the Xalan and/or TestXSLT executable</link>).<br/><br/></li>
<li>Use Visual C++ to open the Xalan workspace from the xml-xalan\c\Projects\Win32\VC6.
<br/><br/></li>
<li>Use Visual C++ to rebuild everything or specific dynamic link libraries and executables of
@@ -185,8 +185,8 @@
<code>make</code><br/>
or<br/>
<code>make <ref>targ</ref></code><br/><br/>
- where <ref>targ</ref> is ommitted or is <code>all</code> (rebuild all), <code>lib</code> (the XSLT libary), or
- <code>testXSLT</code> (the testSXSLT executable). ICUBridge is included in the build of TestXSLT if XALAN_USE_ICU is
+ where <ref>targ</ref> is ommitted or is <code>all</code> (rebuild all), <code>lib</code> (the XSLT libary), <code>Xalan</code> (the Xalan executable), or
+ <code>testXSLT</code> (the testXSLT executable). ICUBridge is included in the build of Xalan and TestXSLT if XALAN_USE_ICU is
defined.<br/><br/></li>
</ol>
<note>The command you use for setting environment variables depends on the shell you are
1.34 +1 -1 xml-xalan/c/xdocs/sources/xalan/samples.xml
Index: samples.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/samples.xml,v
retrieving revision 1.33
retrieving revision 1.34
diff -u -r1.33 -r1.34
--- samples.xml 2001/12/20 13:57:15 1.33
+++ samples.xml 2001/12/20 22:12:29 1.34
@@ -71,7 +71,7 @@
<li><link anchor="threadsafe">ThreadSafe</link></li>
<li><link anchor="xpathwrapper">XPathWrapper</link></li>
<li><link anchor="simplexpathapi">SimpleXPathAPI</link></li>
- <li><link anchor="simplexapthcapi">SimpleXPathCAPI</link></li>
+ <li><link anchor="simplexpathcapi">SimpleXPathCAPI</link></li>
<li><link anchor="serializenodeset">SerializeNodeSet</link></li>
<li><link anchor="externalfunctions">ExternalFunctions</link></li>
<li><link anchor="apachemodulexslt">ApacheModuleXSLT</link></li>
1.32 +14 -2 xml-xalan/c/xdocs/sources/xalan/usagepatterns.xml
Index: usagepatterns.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/usagepatterns.xml,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -r1.31 -r1.32
--- usagepatterns.xml 2001/12/20 13:57:15 1.31
+++ usagepatterns.xml 2001/12/20 22:12:29 1.32
@@ -154,8 +154,12 @@
theXalanTransformer.transform("foo.xml","foo.xsl","foo-out.xml")</source>
<note>If the expression is a string, enclose it in single quotes to make it a string expression.</note>
<p>You can include the -param flag with two arguments when you call the <link idref="commandline">command line utility</link>. The first argument is the parameter name or key, and the second argument is the string expression (in single quotes). For example:</p>
+<p><code>Xalan -p param1 'boo' foo.xml foo.xsl</code></p>
+<p>or</p>
<p><code>TestXSLT -in foo.xml -xsl foo.xsl -param param1 'boo'</code></p>
<p>If the string expression includes spaces or other characters that the shell intercepts, first enclose the string in single quotes so &xslt4c; interprets it as a string expression, and then enclose the resulting string in double quotes so the shell interprets it as a single argument. For example:</p>
+<p><code>Xalan -p "'hello there'" foo.xml foo.xsl</code></p>
+<p>or</p>
<p><code>TestXSLT -in foo.xml -xsl foo.xsl -param param1 "'hello there'"</code></p>
<p>The <link idref="samples" anchor="usestylesheetparam">UseStylesheetParam</link> sample application also uses a command-line parameter.</p>
</s2><anchor name="incremental"/>
@@ -245,7 +249,12 @@
XMLFileReporter &logFile)
{
DOMParser the Parser;
+
+ // You MUST instruct the Xerces DOMParser NOT to create a DOM_XMLDecNode
+ // in the DOM to represent the XML declaration. See "Limitations" above.
theParser.setToCreateXMLDeclTypeNode(false);
+
+ // Turn on validatiion and namespace support.
theParser.setDoValidation(true);
theParser.setDoNamespaces(true);
@@ -253,7 +262,10 @@
DOM_Document theDOM = theParser.getDocument();
theDOM.normalize();
XercesDOMSupport theDOMSupport;
- XercdesParserLiaison theParserLiaison(theDOMSupport);
+ XercesParserLiaison theParserLiaison(theDOMSupport);
+
+ // Use the DOM to create a XercesDOMWrapperParsedSource,
+ // which you can pass to the transform method.
try
{
const XercesDOMWrapperParsedSource parsedSource(
@@ -288,7 +300,7 @@
<li>Result tree generation events</li>
</ul>
<p>To construct a TraceListener with TraceListenerDefault, you need a PrintWriter and a boolean for each of these four tracing options. You can then use the XSLTEngimeImpl setTraceSelects and addTraceListener methods to add the TraceListener to an XSLTProcessor. See the <link idref="samples" anchor="tracelisten">TraceListen</link> sample application.</p>
-<p>The <link idref="commandline">command-line utility (testXSLT)</link> and TraceListen both use TraceListenerDefault to write events to the screen.</p>
+<p>The <link idref="commandline" anchor="testxslt">testXSLT command-line utility</link> and TraceListen both use TraceListenerDefault to write events to the screen.</p>
</s2><anchor name="icu"/>
<s2 title="Using the ICU">
<p>You can use the <resource-ref idref="icu"/> to extend support for encoding, number
---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org