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: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
