dleslie 01/02/09 07:08:06
Modified: c/xdocs/sources entities.ent
c/xdocs/sources/xalan faq.xml getstarted.xml index.xml
resources.xml samples.xml usagepatterns.xml
Log:
preliminary updates for xalan-c 1.2
Revision Changes Path
1.13 +3 -1 xml-xalan/c/xdocs/sources/entities.ent
Index: entities.ent
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/entities.ent,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- entities.ent 2001/02/08 15:54:38 1.12
+++ entities.ent 2001/02/09 15:08:02 1.13
@@ -3,10 +3,11 @@
<!ENTITY xslt4c "Xalan-C++">
<!ENTITY xslt4c-dist "Xalan-C_1_2">
<!ENTITY xslt4c-current "Xalan-C++ version 1.2">
-<!ENTITY xslt4c-windlls "DOMSupport.dll, PlatformSupport.dll, XalanDOM.dll,
XercesParserLiaison.dll, XMLSupport.dll, XPath.dll, XSLT.dll">
+<!ENTITY xslt4c-windlls "DOMSupport.dll, PlatformSupport.dll, XalanDOM.dll,
XercesParserLiaison.dll, XMLSupport.dll, XPath.dll, XSLT.dll,
XalanTransformer.dll">
<!ENTITY xslt4c-linuxlib "libxalan-c1_2.so">
<!ENTITY xslt4c-aixlib "libxalan-c1_2.a">
<!ENTITY xslt4c-hplib "libxalan-c1_2.sl">
+<!ENTITY xslt4c-solarislib "libxalan-c1_2.xxxx">
<!ENTITY xml4c "Xerces-C++">
<!ENTITY xml4c-used "Xerces-C++ version 1.4.0">
<!ENTITY xml4c-windll "xerces-c_1_4.dll">
@@ -14,6 +15,7 @@
<!ENTITY xml4c-linuxlib "libxerces-c1_4.so">
<!ENTITY xml4c-aixlib "libxerces-c1_4.a">
<!ENTITY xml4c-hplib "libxerces-c1_4.sl">
+<!ENTITY xml4c-solarislib "libxerces-c1_4.xxxx">
<!ENTITY xslt4j "Xalan-Java">
<!ENTITY icu-used "International Components for Unicode(ICU) 1.6 source
files">
<!ENTITY icu-windlls "icui18n.dll, icuuc.dll">
1.9 +94 -0 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.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- faq.xml 2001/02/08 15:54:52 1.8
+++ faq.xml 2001/02/09 15:08:03 1.9
@@ -14,6 +14,21 @@
<p>For a brief listing of tutorials, discussion forums, and other
materials, see <link idref="overview"
anchor="uptospeed">Getting up to speed with XSLT</link>.</p></a>
</faq>
+
+<faq title="Questions"><q>Where can I ask question?</q>
+
+<a><p>For generic questions about XSL stylesheets and transformations, use
the XSL-list hosted by Mulberry Technologies. There is an archive that can be
searched as well. Specific questions about &xslt4c; can be asked on the
Xalan-dev list. Please review this document and the archives before posting new
questions.</p>
+
+<p>For specific questions on &xslt4c;: <jump
href="http://xml-archive.webweaving.org/xml-archive-xalan";>http://xml-archive.webweaving.org/xml-archive-xalan</jump>.</p>
+<p>For general questions on XSLT: <jump
href="http://www.biglist.com/lists/xsl-list/";>http://www.biglist.com/lists/xsl-list/</jump>.</p></a>
+</faq>
+
+<faq title="What is &xml4c;?">
+<q>What is &xml4c; and why do I need it?</q>
+
+<a><p>&xml4c; is a validating XML parser written in a portable subset of
C++. &xml4c; makes it easy to give your application the ability to read and
write XML data. Like &xslt4c;, &xml4c; is available from the Apache XML site:
http://xml.apache.org/xerces-c/index.html</p></a>
+</faq>
+
<faq title="Which version of Xerces should I be using?">
<q>Which version of Xerces should I be using?</q>
@@ -21,6 +36,79 @@
<a><p>The &xslt4c; release notes includes information about the &xml4c;
release with which the &xslt4c; release has been coordinated and tested. See
<link idref="readme" anchor="status">Status</link></p></a>
</faq>
+<faq title="Problems with samples in Windows">
+<q>I have encountered problem executing the &xslt4c; sample applications
after rebuilding them under Win32 Environment (Windows NT 4.0, SP3). When I
tried to execute the sample program, I receive the error message "Debug
Assertion Failed! ... Expression: _BLOCK_TYPE_IS_VALID(pHead->nBlockUse)"</q>
+
+<a><p>You may be mixing debug and release versions of executables and
libraries. In other words, if you are compiling the sample for debug, then you
should link with the debug version of the &xslt4c; and &xml4c; libraries and
run with the debug version of the dynamic link libraries.</p></a>
+</faq>
+
+<faq title="Building on Windows">
+<q>What do I need to rebuild &xslt4c; on Windows?</q>
+
+<a><p>To build &xslt4c; on Windows, you need &xml4c; and MS Visual C++ 6.0
installed with Service Pack 3 for Visual C++ and Visual Studio. You should also
apply the bug fixes for the C++ standard library that shipped with Visual C++
6.0. These fixes are available from the Dinkumware site:<jump
href="http://www.dinkumware.com/vc_fixes.html";>http://www.dinkumware.com/vc_fixes.html</jump>.</p>
+<p>For more details, see <link idref="readme" anchor="win32">Steps for doing
a Windows build</link>.</p></a>
+</faq>
+
+<faq title="Building on UNIX">
+<q>What do I need to rebuild &xslt4c; on UNIX?</q>
+
+<a><p>To build &xslt4c; on supported UNIX platforms, you need &xml4c; and a
supported C++ compilers (see the table below). If your compiler does not
support the STL or its implementation is old, you must install the STLPort.</p>
+<p>For more details see: http://xml.apache.org/xalan-c/readme.html#unix</p>
+ <table>
+ <tr>
+ <th>Platform - Operating System</th>
+ <th>Compilers</th>
+ <th>STLPort Required</th>
+ </tr>
+ <tr>
+ <td>AIX 4.3</td>
+ <td>IBM C and C++ for AIX 3.6.6</td>
+ <td>Yes</td>
+ </tr>
+ <tr>
+ <td>Solaris 2.6</td>
+ <td>Workshop 4.2</td>
+ <td>Yes</td>
+ </tr>
+ <tr>
+ <td>HP/UX 11.0</td>
+ <td>aCC A.03.27</td>
+ <td>No</td>
+ </tr>
+ <tr>
+ <td>Red Hat Linux 6.1</td>
+ <td>glib-2.1.2-11</td>
+ <td>No</td>
+ </tr>
+ </table>
+ <p>For more details see: <link idref="readme" anchor="unix">Steps for doing
a UNIX build</link>.</p>
+</a></faq>
+
+<faq title="STLPort">
+<q>What is STLPort and why do I need it?</q>
+
+<a><p>The Standard Template Library, or STL, is a C++ library of container
classes, algorithms, and iterators; it provides many of the basic computer
science algorithms and data structures. &xslt4c; implementation uses the SLT.
STLport ports SGI STL to any platform possible and provides all necessary
wrap-upsinstalled. If your compiler does not support the STL or its
implementation is out of date, you will need to install the STLPort.</p>
+
+<p>The STLPort is available for download from the site: <jump
href="http://www.stlport.org/";>http://www.stlport.org/</jump>.</p>
+
+<p>For more details on the STL, see: <jump
href="http://www.sgi.com/Technology/STL/stl_introduction.html";>http://www.sgi.com/Technology/STL/stl_introduction.html</jump>.</p></a>
+</faq>
+
+<faq title="ICU">
+<q>What is ICU and why do I need it?</q>
+
+<a><p>The International Components for Unicode(ICU) is a C and C++ library
that provides robust and full-featured Unicode support on a wide variety of
platforms. &xslt4c; uses the ICU to extend support for encoding, number
formatting, and sorting.</p>
+<p>The ICU is available for download from <jump
href="http://oss.software.ibm.com/developerworks/opensource/icu/project/index.html";>http://oss.software.ibm.com/developerworks/opensource/icu/project/index.html</jump>.</p>
+<p>For more details see: <link idref="usagepatterns" anchor="icu">Using the
International Components for Unicode (ICU)</link>.</p></a>
+</faq>
+
+<faq title="&xslt4c; in Apache">
+<q>Is it possible to run &xslt4c; from an Apache server?</q>
+
+<a><p>A simple Apache module called <link idref="samples"
anchor="apachemodulexslt">ApacheModuleXSLT</link> is provides as a sample. It
demonstrates how to integrate &xslt4c; with Apache.</p></a>
+</faq>
+
+
<faq title="Are the XSLTEngineImpl (XSLT processor) and StylesheetRoot
(compiled stylesheet) objects thread-safe?">
<q>Are the XSLTEngineImpl (XSLT processor) and StylesheetRoot (compiled
stylesheet) objects thread-safe?</q>
@@ -71,4 +159,10 @@
<p>You can use the xsl:stylesheet doctype defined in xsl-html40s.dtd
for stylesheets that generate HTML.</p>
</a>
</faq>
+
+<faq title="Patches">
+<q>Who do I submit patches to?</q>
+<a><p>Your contributions are much appreciated! Please e-mail your patches to
<human-resource-ref idref="xalandev"/>.</p></a>
+</faq>
+
</faqs>
1.20 +8 -1 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.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- getstarted.xml 2001/02/08 15:54:53 1.19
+++ getstarted.xml 2001/02/09 15:08:03 1.20
@@ -11,7 +11,7 @@
</ul>
<anchor name="download"/>
<s2 title="Downloading what you need">
-<p>For &xslt4c-current;, we are distributing a Windows32 Visual C++ build
and three UNIX builds with a makefile: a Red Hat Linux GNU build, an AIX xlC_r
build, and an HP-UX 11 aCC build.
+<p>For &xslt4c-current;, we are distributing a Windows32 Visual C++ build
and four UNIX builds with a makefile: a Red Hat Linux GNU build, an AIX xlC_r
build, an HP-UX 11 aCC build, and a Solaris build.
Please contact us at <human-resource-ref idref="xalandev"/> if you would
like to help provide builds for other platforms.</p>
<anchor name="xalandists"/>
<s3 title="&xslt4c; Windows Distribution">
@@ -24,6 +24,7 @@
<p>For the Linux build, download <resource-ref
idref="xslt4c-linux-download"/></p>
<p>For the AIX build, download <resource-ref
idref="xslt4c-aix-download"/></p>
<p>For the HP-UX 11 build, download <resource-ref
idref="xslt4c-hp-ux-download"/></p>
+<p>For the Solaris build, download <resource-ref
idref="xslt4c-solaris-download"/></p>
<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>
<s3 title="What you need to run the Xalan command-line utility">
@@ -52,6 +53,12 @@
<li>The executable: TestXSLT</li>
<li>The Xalan-C++ shared library: &xslt4c-hplib;</li>
<li>The Xerces-C++ shared library: &xml4c-hplib;</li>
+</ul>
+<p><em>Solaris</em></p>
+<ul>
+ <li>The executable: TestXSLT</li>
+ <li>The Xalan-C++ XXX library: &xslt4c-solarislib;</li>
+ <li>The Xerces-C++ XXX 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>For information about using the command-line utility, see <link
idref="commandline">Command-Line Utility</link>.</p>
1.17 +8 -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.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- index.xml 2001/02/08 15:54:56 1.16
+++ index.xml 2001/02/09 15:08:04 1.17
@@ -65,8 +65,9 @@
document types.</p>
<p>&xslt4c-current; is a robust implementation of the W3C
Recommendations
for XSL Transformations (XSLT) and the XML Path Language (XPath). It
includes a custom release of the
- &xml4c; XML parser: &xml4c-used;. In addition to adding a build for
HP-UX 11, the focus for this release
- is on bug fixes and performance enhancements. For the details, see the
<link idref="readme">Release Notes</link>.</p>
+ &xml4c; XML parser: &xml4c-used;. In addition to adding a build for
Solaris, the focus for this release
+ is on bug fixes, performance enhancements, and packaging a simpler C++
and C API for performing standard transformations.
+ For the details, see the <link idref="readme">Release Notes</link>.</p>
</s2>
<s2 title="How do I get it?">
@@ -93,6 +94,10 @@
<tr>
<td>HP-UX 11</td>
<td><resource-ref idref="xslt4c-hp-ux-download"/></td>
+ </tr>
+ <tr>
+ <td>Solaris</td>
+ <td><resource-ref idref="xslt4c-solaris-download"/></td>
</tr>
</table>
<p>Volunteers are more than welcome to help develop builds for other
platforms!</p>
@@ -100,7 +105,7 @@
<s2 title="Where do I get Xerces?">
<p>Right here! The distributions include everything you need to build
and run applications that use Xalan and Xerces. Each distribution file includes
the Xerces source tree along with the appropriate Xerces runtime environment
for Xalan: &xml4c-windll; for
- Windows, &xml4c-linuxlib; for Linux, &xml4c-aixlib; for AIX, and
&xml4c-hplib; for HP-UX 11.</p>
+ Windows, &xml4c-linuxlib; for Linux, &xml4c-aixlib; for AIX,
&xml4c-hplib; for HP-UX 11, and &xml4c-solarislib; for Solaris.</p>
</s2>
<s2 title="How about support for internationalization?">
<p>To extend Unicode support for encoding, number formatting, and
sorting, you can download,
1.11 +1 -0 xml-xalan/c/xdocs/sources/xalan/resources.xml
Index: resources.xml
===================================================================
RCS file: /home/cvs/xml-xalan/c/xdocs/sources/xalan/resources.xml,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -r1.10 -r1.11
--- resources.xml 2001/02/08 15:55:02 1.10
+++ resources.xml 2001/02/09 15:08:04 1.11
@@ -23,6 +23,7 @@
<resource id="xslt4c-linux-download" title="&xslt4c-dist;-linux.tar.gz"
location="http://xml.apache.org/dist/xalan-c/&xslt4c-dist;-linux.tar.gz"/>
<resource id="xslt4c-aix-download" title="&xslt4c-dist;-aix.tar.gz"
location="http://xml.apache.org/dist/xalan-c/&xslt4c-dist;-aix.tar.gz"/>
<resource id="xslt4c-hp-ux-download" title="&xslt4c-dist;-hp-ux.tar.gz"
location="http://xml.apache.org/dist/xalan-c/&xslt4c-dist;-hp-ux.tar.gz"/>
+<resource id="xslt4c-solaris-download" title="&xslt4c-dist;-solaris.tar.gz"
location="http://xml.apache.org/dist/xalan-c/&xslt4c-dist;-solaris.tar.gz"/>
<resource id="icu" title="International Components for Unicode (ICU)"
location="http://oss.software.ibm.com/developerworks/opensource/icu/project/index.html"/>
<resource id="icu-download" title="International Components for Unicode
(ICU) 1.6 source files"
location="http://oss.software.ibm.com/developerworks/opensource/icu/project/download/index.html"/>
1.19 +8 -0 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.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- samples.xml 2001/02/08 15:55:03 1.18
+++ samples.xml 2001/02/09 15:08:04 1.19
@@ -60,6 +60,7 @@
<s1 title="&xslt4c; Samples">
<ul>
<li><link anchor="getstarted">Samples to help you get started</link></li>
+ <li><link anchor="xalantransform">XalanTransform</link></li>
<li><link anchor="simpletransform">SimpleTransform</link></li>
<li><link anchor="streamtransform">StreamTransform</link></li>
<li><link anchor="usestylesheetparam">UseStylesheetParam</link></li>
@@ -68,6 +69,7 @@
<li><link anchor="threadsafe">ThreadSafe</link></li>
<li><link anchor="xpathwrapper">XPathWrapper</link></li>
<li><link anchor="externalfunctions">ExternalFunctions</link></li>
+ <li><link anchor="apachemodulexslt">ApacheModuleXSLT</link></li>
</ul>
<anchor name="getstarted"/>
@@ -89,6 +91,9 @@
files. For the UNIX builds, the application executable is also in the
samples subdirectory. For the Windows32 build, however, the
application executable is in the build subdirectory
(xml-xalan\c\Build\Win32\VC6\ Debug and Release). To run a sample, be sure the
executable is on the path, and run it from the samples subdirectory
that contains the input files.</note>
+ </s2><anchor name="xalantransform"/>
+ <s2 title="XalanTransform">
+
</s2><anchor name="simpletransform"/>
<s2 title="SimpleTransform">
<p>What it does: The SimpleTransform class uses the foo.xsl stylesheet
to transform foo.xml, and writes the
@@ -214,5 +219,8 @@
<p>Run this sample from the ExternalFunctions subdirectory with</p>
<p><code>ExternalFunctions</code></p>
<p>See also: <link idref="extensions">Extension Functions</link>.</p>
+ </s2><anchor name="apachemodulexslt"/>
+ <s2 title="ApacheModuleXSLT">
+
</s2>
</s1>
1.15 +25 -0 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.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- usagepatterns.xml 2001/02/08 15:55:05 1.14
+++ usagepatterns.xml 2001/02/09 15:08:05 1.15
@@ -59,6 +59,7 @@
<s1 title="&xslt4c; Basic usage patterns">
<ul>
<li><link anchor="intro">Introduction</link></li>
+<li><link anchor="xalantransformer">Using the XalanTransformer
class</link></li>
<li><link anchor="basic">Basic procedure for performing XSL
transformations</link></li>
<li><link anchor="dom">Working with DOM input and output</link></li>
<li><link anchor="params">Setting stylesheet parameters</link></li>
@@ -75,6 +76,30 @@
<p>&xslt4c; uses &xml4c; to parse text input, performs the transformation,
and sends the output to an instance of <jump
href="apidocs/class_xsltresulttarget.html">XSLTResultTarget</jump>, which may
be configured to write to a file, a stream, or a DOM tree.</p>
<p>For detailed API documentation, see <jump
href="apidocs/index.html">&xslt4c; API</jump>. For an overview of the
command-line utility, see <link idref="commandline">Command-Line
Utility</link>.</p>
+</s2><anchor name="xalantransformer"/>
+<s2 title="Using the XalanTransformer class">
+<p>&xslt4c; 1.2 introduces a new class designed to take care of
configuration and setup under the covers and provide a simpler API for
performing standard transformations. Using XalanTransformer, you can perform
one or more transformations as follows:</p>
+<ol>
+ <li>Include the XalanTransformer header file.<br/>
+ <code>#include
<XalanTransformer/XalanTransformer.hpp</code><br/><br/></li>
+ <li>Initialize Xalan and Xerces.<br/>
+ <code>XalanTransformer::initialize();</code><br/><br/></li>
+ <li>Create a XalanTransformer.<br/>
+ <code>XalanTransformer theXalanTransformer;</code><br/><br/></li>
+ <li>Use one of the XalanTransformer transform() methods to perform each
transformation. For example:<br/>
+ <code>const char* xmlIn = "foo.xml";</code><br/>
+ <code>const char* xslSheet = "foo.xsl";</code><br/>
+ <code>const char* xmlOut = "foo.out";</code><br/>
+ <code>int theResult = 0;</code><br/>
+ <code>theResult =
theXalanTransformer(xmlIn,xslSheet,xmlOut);</code><br/><br/></li>
+ <li>Shut down Xalan and Xerces.<br/>
+ <code>XalanTransformer::terminate();</code></li>
+</ol>
+<p>The XalanTransformer transform() methods also allow you to process and
output streams, and to send the output to a callback
+function. Each transform() method returns an integer code, 0 for success.
For the details, see XalanTransormer/XalanTransformer.hpp in the source tree.
For an example, see the <link idref="samples"
anchor="xalantransform">XalanTransform</link> sample.</p>
+<p>We also include a simple C interface for using the XalanTransformer
class. See XalanTransformer/XalanCAPI.h in the source tree.
+The <link idref="samples" anchor="apachemodulexslt">ApacheModuleXSLT</link>
sample illustrates the use of this C API.</p>
+<note>As we expand the functionality of the XalanTransformer, we will revise
the sections below to indicate how to take advantage of the API it
provides.</note>
</s2><anchor name="basic"/>
<s2 title="Basic procedure for performing an XSL transformation">
<p>When you are setting up your application to use XSL stylesheets to
transform XML documents, you must do the following:</p>
