You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by sh...@apache.org on 2012/06/16 05:57:39 UTC
svn commit: r1350856 [4/11] - in /xalan/site: ./ docs/ docs/xalan/
docs/xalan/resources/ docs/xalan/xalan-c/ docs/xalan/xalan-c/resources/
docs/xalan/xalan-j/ stylebook/ stylebook/Xalan-Logos/ stylebook/css/
stylebook/style/ stylebook/style/dtd/ xdocs/...
Added: xalan/site/docs/xalan/xalan-c/index.html
URL: http://svn.apache.org/viewvc/xalan/site/docs/xalan/xalan-c/index.html?rev=1350856&view=auto
==============================================================================
--- xalan/site/docs/xalan/xalan-c/index.html (added)
+++ xalan/site/docs/xalan/xalan-c/index.html Sat Jun 16 03:57:36 2012
@@ -0,0 +1,537 @@
+<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<head>
+<title>ASF: Xalan-C++ Version 1.11</title>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<link rel="stylesheet" type="text/css" href="resources/apache-xalan.css" />
+</head>
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ -->
+<body>
+<div id="title">
+<table class="HdrTitle">
+<tbody>
+<tr>
+<th rowspan="2">
+<a href="../index.html">
+<img alt="Trademark Logo" src="resources/XalanC-Logo-tm.png" width="190" height="90" />
+</a>
+</th>
+<th text-align="center" width="75%">
+<a href="index.html">Xalan-C/C++ Version 1.11</a>
+</th>
+</tr>
+<tr>
+<td valign="middle">Xalan-C++ Version 1.11</td>
+</tr>
+</tbody>
+</table>
+<table class="HdrButtons" align="center" border="1">
+<tbody>
+<tr>
+<td>
+<a href="http://www.apache.org">Apache Foundation</a>
+</td>
+<td>
+<a href="http://xalan.apache.org">Xalan Project</a>
+</td>
+<td>
+<a href="http://xerces.apache.org">Xerces Project</a>
+</td>
+<td>
+<a href="http://www.w3.org/TR">Web Consortium</a>
+</td>
+<td>
+<a href="http://www.oasis-open.org/standards">Oasis Open</a>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div id="navLeft">
+<ul>
+<li>
+<a href="resources.html">Resources</a>
+<br />
+</li>
+<li>
+<a href="../index.html">Home</a>
+</li></ul><hr /><ul>
+<li>Xalan-C++ 1.11<br />
+</li>
+<li>
+<a href="whatsnew.html">What's New</a>
+</li>
+<li>
+<a href="license.html">Licenses</a>
+</li></ul><hr /><ul>
+<li>
+<a href="overview.html">Overview</a>
+</li>
+<li>
+<a href="charter.html">Charter</a>
+</li></ul><hr /><ul>
+<li>
+<a href="download.html">Download</a>
+</li>
+<li>
+<a href="buildlibs.html">Build Libraries</a>
+</li>
+<li>
+<a href="install.html">Installation</a>
+</li>
+<li>
+<a href="builddocs.html">Build Documents</a>
+</li></ul><hr /><ul>
+<li>
+<a href="samples.html">Sample Apps</a>
+</li>
+<li>
+<a href="commandline.html">Command Line</a>
+</li>
+<li>
+<a href="usagepatterns.html">Usage Patterns</a>
+</li></ul><hr /><ul>
+<li>
+<a href="programming.html">Programming</a>
+</li>
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
+<li>
+<a href="extensionslib.html">Extensions Library</a>
+</li>
+<li>
+<a href="apiDocs/index.html">API Reference</a>
+</li></ul><hr /><ul>
+<li>
+<a href="faq.html">Xalan-C FAQs</a>
+</li></ul><hr /><ul>
+<li>
+<a href="whatsnew.html#bugs">Bugs</a>
+</li>
+<li>
+<a href="http://xml.apache.org/xalan-j/test/run.html#how-to-run-c">Testing</a>
+</li>
+<li>
+<a href="secureweb.html">Web Security</a>
+</li>
+</ul>
+</div>
+<div id="content">
+<h2>Xalan-C++ Version 1.11</h2>
+
+<ul>
+<li>
+<a href="#licenses">Licenses</a>
+</li>
+<li>
+<a href="#getinvolved">Getting Involved</a>
+</li>
+<li>
+<a href="#xsltStandards">XSLT Standards Implemented</a>
+</li>
+<li>
+<a href="#xmlParserLib">XML Parser Library</a>
+</li>
+<li>
+<a href="#securityIssues">Security Issues</a>
+</li>
+<li>
+<a href="#getstarted">Getting Started</a>
+</li>
+<li>
+<a href="#getWhatNeeded">Getting What You Need</a>
+</li>
+</ul>
+<p>The old Xalan-C/C++ 1.10 release can be found at
+<a href="http://xml.apache.org/xalan-c">xml.apache.org/xalan-c</a>.</p>
+
+<a name="whatisxalan">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>What Is Xalan?</h3>
+
+<p>Xalan is an XSLT processor for transforming XML documents
+into HTML, text, or other XML document types.
+It uses for input an XML document and an XSLT stylesheet.
+The engine also supports the entry of top-level stylesheet parameters.
+Documentation exists on how to extend the library with
+your own custom XPath functions.
+</p>
+<p>Xalan-C++ version 1.11 is a robust implementation of the
+W3C Recommendations for
+<a href="http://www.w3.org/TR/xslt">XSL Transformations (XSLT)</a>
+and the
+<a href="http://www.w3.org/TR/xpath">XML Path Language (XPath)</a>.
+It works with the
+<a href="http://xerces.apache.org/xerces-c">Xerces-C++ version 3.1.1</a>
+release of XML parsers.
+The focus for this Xalan release is on bug fixes and
+compatibility with newer development platforms.
+</p>
+<p>The Xalan-C/C++ project creates and distributes a
+standard XSLT library and a simple Xalan command-line
+utility for transforming XML documents.
+</p>
+<p>This project is written in a reduced set of the C++ programming language.
+This makes the library directly usable on numerous platforms.
+A set of 'C' language APIs is also available so that
+XSLT and XPath functionality is easily deployed to 'C' language applications.
+</p>
+<p>
+<a href="samples.html">Sample programs</a> are available
+for you to test and experiment with as you learn the Xalan library.
+</p>
+<p>Some of the <a href="http://www.exslt.org">EXSLT extension functions</a>
+for XPath are available.
+We need to write and validate more of the EXSLT functions.
+Apache also provides some of their own
+<a href="extensionslib.html">XPath extensions</a> for use.
+Documentation and examples are available for you to write
+your own custom <a href="extensions.html">XPath extensions</a>.
+</p>
+<p>There is a library of <a href="extensionslib.html">XPath extensions</a>
+that are provided by the Apache Xalan community.
+</p>
+
+
+<a name="licenses">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Licenses</h3>
+
+<p>The Xalan-C/C++ software conforms to The Apache Software Foundation
+<a href="license.html">License, Version 2.0</a>.
+</p>
+
+
+<a name="getinvolved">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Getting Involved</h3>
+
+<p>You are invited to participate in
+<a href="http://www.apache.org/foundation/getinvolved.html">The Apache Software Foundation</a>.
+You will need to subscribe if you wish to receive mail from the lists.
+Some lists require a subscription in order to post messages.
+</p>
+<p>The <a href="mailto:xalan-dev@xml.apache.org">xalan-dev</a> mailing list
+is used to communicate product development issues with the software development team.
+The xalan-dev messages are
+<a href="http://mail-archives.apache.org/mod_mbox/xml-xalan-dev">archived here</a>
+and on <a href="http://marc.info/?l=xalan-dev">Marc.info</a>.
+</p>
+<p>The <a href="mailto:xalan-c-users@xml.apache.org">xalan-c-users</a> mailing list
+is used to discuss issues regarding the use of the Xalan-C/C++ software and libraries.
+The xalan-c-users messages are
+<a href="http://mail-archives.apache.org/mod_mbox/xml-xalan-c-users">archived here</a>
+and on <a href="http://marc.info/?l=xalan-c-users">Marc.info</a>.
+</p>
+<p>The subversion repository changes are logged on the xalan-cvs mailing list and are
+<a href="http://mail-archives.apache.org/mod_mbox/xml-xalan-cvs">archived here</a>
+and on <a href="http://marc.info/?l=xalan-cvs">Marc.info</a>.
+</p>
+<p>You can review the project sources and change history in the subversion repository at
+<a href="http://svn.apache.org/viewvc/xalan/c">http://svn.apache.org/viewvc/xalan/c</a>.
+</p>
+<p>You can get a private copy of the subversion snapshot of the development sources at
+<a href="http://svn.apache.org/repos/asf/xalan/c/trunk">http://svn.apache.org/repos/asf/xalan/c/trunk</a>
+using your favorite SVN program.
+</p>
+<p>The JIRA system is used for issue tracking.
+You must create an account before you can post messages and files to the JIRA tracking system.
+You can view the issues at
+<a href="https://issues.apache.org/jira/browse/XALANC">https://issues.apache.org/jira/browse/XALANC</a>.
+</p>
+
+
+<a name="xsltStandards">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>XSLT Standards Implemented</h3>
+
+<p>Xalan-C/C++ implements the following specifications from the World Wide Web Consortium (W3C).
+</p>
+<ul>
+<li>
+<a href="http://www.w3.org/TR/xslt">XSL Transformations (XSLT) Version 1.0</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xpath">XML Path Language (XPath) Version 1.0</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xml-stylesheet">Associating Style Sheets with XML documents 1.0 (Second Edition)</a>
+</li>
+</ul>
+
+<p>The next major release of Xalan-C/C++ will hopefully be compatible with following standards. This added support will require a major version change from 1 to 2.
+</p>
+<ul>
+<li>
+<a href="http://www.w3.org/TR/xslt20">XSL Transformations (XSLT) Version 2.0</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xslt-xquery-serialization">XSLT 2.0 and XQuery 1.0 Serialization</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xpath20">XML Path Language (XPath) Version 2.0 (Second Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xquery-semantics">XQuery 1.0 and XPath 2.0 Formal Semantics (Second Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xpath-datamodel">XQuery 1.0 and XPath 2.0 Data Model (XDM) (Second Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xpath-functions">XQuery 1.0 and XPath 2.0 Functions and Operators (Second Edition)</a>
+</li>
+</ul>
+
+
+
+<a name="xmlParserLib">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>XML Parser Library</h3>
+
+<p>Xalan-C/C++ uses the The Apache Software Foundation Xerces-C project that implements parsers for XML 1.0 and XML 1.1.
+The following standards as specified by the
+<a href="http://www.w3.org/TR">World Wide Web Consortium (W3C)</a> are implemented by the
+<a href="http://xerces.apache.org/xerces-c">Xerces-C</a> XML parser library.
+</p>
+<ul>
+<li>
+<a href="http://www.w3.org/TR/xml">Extensible Markup Language (XML) 1.0 (Third Edition) - currently (Fifth Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xml11">Extensible Markup Language (XML) 1.1 (First Edition) - currently (Second Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xml-id">xml:id Version 1.0</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xmlbase">XML Base (Second Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xml-infoset">XML Information Set (Second Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xml-names">Namespaces in XML 1.0 (Third Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xml-names11">Namespaces in XML 1.1 (Second Edition)</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xmlschema-1">XML Schema Part 1: Structures Second Edition</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xmlschema-2">XML Schema Part 2: Datatypes Second Edition</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/REC-DOM-Level-1">Document Object Model (DOM) Level 1</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/ElementTraversal">Element Traversal Specification</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/DOM-Level-2-Core">Document Object Model (DOM) Level 2 Core Specification</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/DOM-Level-2-Traversal-Range">Document Object Model (DOM) Level 2 Traversal and Range Specification</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/DOM-Level-3-Core">Document Object Model (DOM) Level 3 Core Specification</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/DOM-Level-3-Val">Document Object Model (DOM) Level 3 Validation Specification</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/DOM-Level-3-LS">Document Object Model (DOM) Level 3 Load and Save Specification</a>
+</li>
+<li>
+<a href="http://www.w3.org/TR/xinclude">XML Inclusions (XInclude) 1.0 (Second Edition)</a>
+</li>
+</ul>
+<p>The Xerces-C/C++ also supports the <a href="http://sax.sourceforge.net/">SAX 1.0 and SAX 2.0</a> projects.
+SAX is primarily Java based. The Xerces-C/C++ project has implemented a SAX C++ API that looks much like the SAX Java API.
+</p>
+<p>Web Services and Web Security recommendations have been developed by the
+<a href="http://www.w3.org">World Wide Web Consortium (W3C)</a> and
+<a href="http://www.oasis-open.org">OASIS-OPEN</a> Advancing open standards for the information society.
+The Xerces-C/C++ has support for custom entity resolvers which are inherited and
+supported by the Xalan-C/C++ library.
+</p>
+
+
+<a name="securityIssues">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Security Issues</h3>
+
+<p>The Xalan-C/C++ library has hooks so that custom entity resolvers can be deployed.
+The entity resolvers are actually interfaces into the Xerces-C/C++ XML Parser Library.
+Use of trusted entity resolvers greatly increases the security of XML based applications.
+</p>
+<p>The Web Services Architecture uses specifications and recommendations
+that are documented by the following organizations.
+</p>
+<ul>
+<li>World Wide Web Consortium (W3C)<br />
+ [<a href="http://www.w3.org">http://www.w3.org]</a>]</li>
+<li>Advancing open standards for the information society (OASIS-OPEN)<br />
+ [<a href="http://www.oasis-open.org">http://www.oasis-open.org</a>]</li>
+<li>The Sourceforge SAX Project (SAX1, SAX2)<br />
+ [<a href="http://sax.sourceforge.net">http://sax.sourceforge.net</a>]</li>
+<li>Internet Engineering Task Force (IETF)<br />
+ [<a href="http://www.ietf.org">http://www.ietf.org</a>]</li>
+</ul>
+<p>There are some <a href="secureweb.html">architecture security</a> issues
+that should be addressed by any XML parser or XSLT transformation application.
+Other than validating and cleaning the content of XML elements,
+the access to untrusted external entities is a big problem for security management.
+</p>
+<p>The "Xalan" comman-line transformation program does not deploy
+an OASIS catalog or perform other security measures.
+URLs are resolved using the system directory of the local machine
+and DNS to resolve host locations.
+The "Xalan" program should be used only with
+trusted XSLT stylesheets and XML documents on a trusted computer.
+</p>
+<p>A future release of the "Xalan" command-line transformation program
+may include support for an OASIS entity resolver catalog.
+</p>
+<p>Information on creating Secure Web Service Applications is useful for review.
+This <a href="secureweb.html">security overview document</a> goes beyond the scope of
+XSLT transformations and asks many pertinent security based questions.
+</p>
+
+
+<a name="getstarted">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Getting Started</h3>
+
+<p>The source code and documentation are delivered in separate packages.
+Binary packages comprise the compiled libraries, the Xalan command line utility, and the C/C++ header files.
+The documentation package contains the pre-built documentation.
+The source package contains the sources to build everything.
+</p>
+<p>The current Xalan-C/C++ Version 1.11 is compatible with the stable releases of
+<a href="http://xerces.apache.org/xerces-c">Xerces-C/C++</a> Version 3.0 and newer. The current stable release for Xerces-C/C++ is 3.1.1.
+</p>
+<p>The previous Xalan-C/C++ Version 1.10 works with Xerces-C/C++ Versions 2.7.0 and 2.8.0.
+</p>
+<p>If you are having problems using the product,
+send your comments to the <a href="mailto:xalan-c-users@xml.apache.org">xalan-c-users</a> mail list.
+</p>
+<p>If you think a change needs to be made or have suggestions for future releases,
+send your comments to the <a href="mailto:xalan-dev@xml.apache.org">xalan-dev</a> mail list.
+</p>
+<p>Binary releases are not yet available.
+We would like to distribute Xalan-C/C++ Version 1.11 binary releases
+using the same platforms specified for the compatible Xerces-C binary packages.
+</p>
+
+
+<a name="getWhatNeeded">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Getting What You Need</h3>
+
+<p>What you need depends whether you plan to
+build from the sources or download prebuilt packages.
+</p>
+<p>The development platform used to build the Xalan-C/C++ (XSLT) library
+should be the same as the platform used to build the Xerces-C/C++ (XML) parser library.
+</p>
+<p>Xalan-C/C++ (XSLT) library requires a working Xerces-C/C++ (XML) parser library.
+The supported versions of Xerces-C/C++ version 3.0 or newer. Version 3.1.1
+is recommended.
+</p>
+<p>If you are ambitious and willing to experiment,
+you can download the bleeding edge development from the
+Apache Software Foundation subversion repositories.
+Use your favorite subversion 'svn' utility for download.
+</p>
+<table border="1">
+<tr>
+<td class="content" rowspan="1" colspan="1">Xalan-C Repository</td>
+<td class="content" rowspan="1" colspan="1">http://svn.apache.org/repos/asf/xalan/c/trunk</td>
+</tr>
+<tr>
+<td class="content" rowspan="1" colspan="1">Xerces-C Repository</td>
+<td class="content" rowspan="1" colspan="1">http://svn.apache.org/repos/asf/xerces/c/trunk</td>
+</tr>
+</table>
+
+<p>The current stable
+<a href="http://xerces.apache.org/xerces-c/download.cgi">Xerces-C/C++ (XML) packages</a>
+are available for download.
+</p>
+<table class="note">
+<tr>
+<td class="noteImg">
+<img src="resources/note.gif" alt="note" />
+</td>
+<td class="noteTxt">The sources from the Xalan-C repository are current for Version 1.11
+until released packages are available.
+You can help us prepare for a Version 1.11 release
+by providing packages for your platforms
+and let us know of your building issues.
+</td>
+</tr>
+</table>
+<br />
+
+<p>The previous version packages can still be downloaded until officially replaced.
+</p>
+<table border="1">
+<tr>
+<td class="content" rowspan="1" colspan="1">Xalan-C Version 1.10</td>
+<td class="content" rowspan="1" colspan="1">
+<a href="http://www.apache.org/dyn/closer.cgi/xml/xalan-c/">Xalan Package Downloads</a>
+</td>
+</tr>
+<tr>
+<td class="content" rowspan="1" colspan="1">Xerces-C Version 2.7</td>
+<td class="content" rowspan="1" colspan="1">
+<a href="http://www.apache.org/dyn/closer.cgi/xml/xerces-c/">Xerces Package Downloads</a>
+</td>
+</tr>
+</table>
+
+
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+</div>
+<div id="footer">Copyright © 1999-2012 The Apache Software Foundation<br />Apache, Xalan, and the Feather logo are trademarks of The Apache Software Foundation<div class="small">Web Page created on - Fri 06/15/2012</div>
+</div>
+</body>
+</html>
Added: xalan/site/docs/xalan/xalan-c/install.html
URL: http://svn.apache.org/viewvc/xalan/site/docs/xalan/xalan-c/install.html?rev=1350856&view=auto
==============================================================================
--- xalan/site/docs/xalan/xalan-c/install.html (added)
+++ xalan/site/docs/xalan/xalan-c/install.html Sat Jun 16 03:57:36 2012
@@ -0,0 +1,381 @@
+<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<head>
+<title>ASF: Installing Xalan-C++</title>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<link rel="stylesheet" type="text/css" href="resources/apache-xalan.css" />
+</head>
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ -->
+<body>
+<div id="title">
+<table class="HdrTitle">
+<tbody>
+<tr>
+<th rowspan="2">
+<a href="../index.html">
+<img alt="Trademark Logo" src="resources/XalanC-Logo-tm.png" width="190" height="90" />
+</a>
+</th>
+<th text-align="center" width="75%">
+<a href="index.html">Xalan-C/C++ Version 1.11</a>
+</th>
+</tr>
+<tr>
+<td valign="middle">Installing Xalan-C++</td>
+</tr>
+</tbody>
+</table>
+<table class="HdrButtons" align="center" border="1">
+<tbody>
+<tr>
+<td>
+<a href="http://www.apache.org">Apache Foundation</a>
+</td>
+<td>
+<a href="http://xalan.apache.org">Xalan Project</a>
+</td>
+<td>
+<a href="http://xerces.apache.org">Xerces Project</a>
+</td>
+<td>
+<a href="http://www.w3.org/TR">Web Consortium</a>
+</td>
+<td>
+<a href="http://www.oasis-open.org/standards">Oasis Open</a>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div id="navLeft">
+<ul>
+<li>
+<a href="resources.html">Resources</a>
+<br />
+</li>
+<li>
+<a href="../index.html">Home</a>
+</li></ul><hr /><ul>
+<li>
+<a href="index.html">Xalan-C++ 1.11</a>
+</li>
+<li>
+<a href="whatsnew.html">What's New</a>
+</li>
+<li>
+<a href="license.html">Licenses</a>
+</li></ul><hr /><ul>
+<li>
+<a href="overview.html">Overview</a>
+</li>
+<li>
+<a href="charter.html">Charter</a>
+</li></ul><hr /><ul>
+<li>
+<a href="download.html">Download</a>
+</li>
+<li>
+<a href="buildlibs.html">Build Libraries</a>
+</li>
+<li>Installation<br />
+</li>
+<li>
+<a href="builddocs.html">Build Documents</a>
+</li></ul><hr /><ul>
+<li>
+<a href="samples.html">Sample Apps</a>
+</li>
+<li>
+<a href="commandline.html">Command Line</a>
+</li>
+<li>
+<a href="usagepatterns.html">Usage Patterns</a>
+</li></ul><hr /><ul>
+<li>
+<a href="programming.html">Programming</a>
+</li>
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
+<li>
+<a href="extensionslib.html">Extensions Library</a>
+</li>
+<li>
+<a href="apiDocs/index.html">API Reference</a>
+</li></ul><hr /><ul>
+<li>
+<a href="faq.html">Xalan-C FAQs</a>
+</li></ul><hr /><ul>
+<li>
+<a href="whatsnew.html#bugs">Bugs</a>
+</li>
+<li>
+<a href="http://xml.apache.org/xalan-j/test/run.html#how-to-run-c">Testing</a>
+</li>
+<li>
+<a href="secureweb.html">Web Security</a>
+</li>
+</ul>
+</div>
+<div id="content">
+<h2>Installing Xalan-C++</h2>
+
+<ul>
+ <li>
+<a href="#SourcePkgs">Install Source Packages</a>
+</li>
+ <li>
+<a href="#BinaryPkgs">Install Binary Packages</a>
+</li>
+ <ul>
+ <li>
+<a href="#InsWin">Install Windows Packages</a>
+</li>
+ <li>
+<a href="#InsUnx">InstallUNIX Packages</a>
+</li>
+ <li>
+<a href="#InsPkgs">Other Packages</a>
+</li>
+ </ul>
+ <li>
+<a href="#XalanDocPkg">Install Documentation Packages</a>
+</li>
+ <ul>
+ <li>
+<a href="">Xalan-C User Guide</a>
+</li>
+ <li>
+<a href="">Xalan-C API Reference</a>
+</li>
+ </ul>
+</ul>
+
+<p>A pre-requisite for using the Xalan-C/C++ XSLT library is to
+ have a working Xerces-C/C++ XML Parser library. Xerces-C/C++
+ must be of version 3.0 or newer. Xerces-C/C++ Version 3.1.1 is preferred.
+</p>
+<p>The Xalan-C/C++ project is providing several types of packages.
+</p>
+<p>Source packages contain all of the source code to build the
+ Xalan-C/C++ library, the sample programs, and the documentation.
+ There are UNIX scripts and Windows project files by which the
+ library and sample programs can be built.
+ There are also scripts for building the User Guide web pages and
+ a Doxygen configuration for building the interactive API Reference.
+</p>
+<p>Binary packages contain compiled libraries and the Xalan
+ command line program. The binary packages also contain C/C++
+ header files for basic software development.
+</p>
+<p>Documentation packages contain pre-built directories of web
+ page html files for the Xalan-C/C++ User Guide and the interactive
+ API Reference for programmers.
+</p>
+
+<a name="SourcePkgs">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Install Source Packages</h3>
+<p>We have no package managers for source packages. You just extract
+ the contents of the distribution <b>
+<i>zip</i>
+</b> file or <b>
+<i>tar</i>
+</b> file
+ into a source directory of your choosing.
+</p>
+<p>You also need to have the necessary C/C++ compiler tools installed
+ and a working copy of the Xerces-C/C++ XML parser library.
+</p>
+<p>Building the
+ <a href="builddocs.html#buildweb">User Guide</a>
+ from sources requires a working Xalan command line program.
+</p>
+<p>Building the interactive
+ <a href="builddocs.html#buildapi">API Reference</a>
+ requires a UNIX or Linux system with a current copy of
+ Doxygen and GraphViz installed.
+</p>
+
+<p>The building of a library from sources results in a directory from which
+ a binary package can be made.
+ <a href="buildlibs.html#unixbldenv">UNIX and Linux builds</a>
+ are automatically targeted to an install destination.
+ <a href="buildlibs.html#winbldinst">Installing a Windows build</a>
+ requires that the specific compiled products be copied to a usable
+ destination directory.
+</p>
+
+
+<a name="BinaryPkgs">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Install Binary Packages</h3>
+<p>The binary packages distributed by <b>
+<i>zip</i>
+</b> files
+ and <b>
+<i>tar</i>
+</b> files are usually extracted to the install
+ <code>{target}</code> directory.
+ After extracting the contents, you then need to manually perform
+ some minor system configuration.
+</p>
+<p>Packages that are handled by a package manager are usually
+ installed and configured according to package maintainer.</p>
+
+<a name="InsWin">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h4>Install Windows Packages</h4>
+<p>The Xalan-C and Xerces-C packages can be installed to the same
+ <code>{target}</code>
+ directory tree. The debug and release builds have different names
+ for the shared <code>*.DLL</code> files.
+</p>
+<p>Windows operating systems require that the <code>{target}\bin</code>
+ directory be added to the PATH environment. You can make the path
+ a permanent part of the SYSTEM or user login DESKTOP environment.
+ The PATH environment variable should contain an entry
+ where the <code>{target}\bin\*.DLL</code> files are found.
+</p>
+<ol>
+ <li>Right-Click on the computer icon.</li>
+ <li>Select Properties.</li>
+ <li>Select Advanced System Settings.</li>
+ <li>Select Environment Variables.</li>
+ <li>Add the <code>{target}\bin</code> directory to the
+ system PATH environment variable.</li>
+</ol>
+<p>The XP, NT, 2000 and 2003 systems allow environment variables to be
+ set explicitly to individual user accounts.
+ The Vista, Win-7, and 2008 systems have security administration that
+ gets in the way of updating individual user environments.
+</p>
+<p>In a command window or a command environment, you can add the following
+ shell command to set a temporary path to the XALAN <code>{target}\bin</code>
+ directory.
+</p>
+<blockquote class="source">
+<pre>set PATH=%PATH%;{target}\bin</pre>
+</blockquote>
+
+
+<a name="InsUnx">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h4>Install UNIX Packages</h4>
+ <p>The path to the <code>Xalan</code> command line executable program should be added
+ to the PATH environment variable.</p>
+ <p>The path to the shared objects should be added to the system
+ configuration or overridden by specific entry in an environment
+ by which shared objects can be found.</p>
+<p>Here is some more detailed information on
+ <a href="buildlibs.html#unixlibpath">UNIX Runtime</a> configuration.
+</p>
+
+<a name="InsPkgs">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h4>Install Other Packages</h4>
+<p>These packages are usually installed and configured by a package manager.
+ You should refer to the documentation provided by the package maintainer.
+</p>
+
+
+
+<a name="XalanDocPkg">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Install Documentation Packages</h3>
+<p>The documentation packages are distributed as <b>
+<i>tar</i>
+</b> files
+ and <b>
+<i>zip</i>
+</b> files. You just extract the files into a directory
+ that is reachable by your favorite web browser. The head of the
+ documentation tree starts at the <a href="index.html">
+ <code>{docs}/xalan-c</code>
+</a> directory.
+</p>
+<p>
+<b>TO DO:</b>
+</p>
+<p>Rework the xalan/c/trunk/xdocs/sources/ scripts so that the
+ source documentation builds are
+ targeted to the xalan/c/trunk/build/docs/xalan-c/ directory path.
+</p>
+<p>Add a documentation script that performs a post-processing
+ operation when building the API Reference from Doxygen to relocate
+ the constructed products to the xalan/c/trunk/build/docs/xalan-c/apiDocs/
+ directory path.
+</p>
+<p>Details are found in our <a href="builddocs.html">Build Documents</a> pages.
+</p>
+
+<a name="DocWebPkg">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h4>Install Xalan-C User Guide</h4>
+<p>Extract the distributed <b>
+<i>tar</i>
+</b> file or <b>
+<i>zip</i>
+</b>
+ file to the <code>{docs}</code> directory. The package populates
+ the <code>{docs}/xalan-c/*</code> directory containing the Xalan-C
+ User Guide web pages.
+</p>
+
+
+<a name="DocApiPkg">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h4>Install Xalan-C API Reference</h4>
+<p>Extract the distributed <b>
+<i>tar</i>
+</b> file or <b>
+<i>zip</i>
+</b>
+ file to the <code>{docs}</code> directory. The package populates
+ the <code>{docs}/xalan-c/apiDocs/*</code> directory containing the
+ Xalan-C API Reference for programmers.
+</p>
+
+
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+</div>
+<div id="footer">Copyright © 1999-2012 The Apache Software Foundation<br />Apache, Xalan, and the Feather logo are trademarks of The Apache Software Foundation<div class="small">Web Page created on - Fri 06/15/2012</div>
+</div>
+</body>
+</html>
Added: xalan/site/docs/xalan/xalan-c/license.html
URL: http://svn.apache.org/viewvc/xalan/site/docs/xalan/xalan-c/license.html?rev=1350856&view=auto
==============================================================================
--- xalan/site/docs/xalan/xalan-c/license.html (added)
+++ xalan/site/docs/xalan/xalan-c/license.html Sat Jun 16 03:57:36 2012
@@ -0,0 +1,393 @@
+<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<head>
+<title>ASF: Apache Software License Version 2.0</title>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<link rel="stylesheet" type="text/css" href="resources/apache-xalan.css" />
+</head>
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ -->
+<body>
+<div id="title">
+<table class="HdrTitle">
+<tbody>
+<tr>
+<th rowspan="2">
+<a href="../index.html">
+<img alt="Trademark Logo" src="resources/XalanC-Logo-tm.png" width="190" height="90" />
+</a>
+</th>
+<th text-align="center" width="75%">
+<a href="index.html">Xalan-C/C++ Version 1.11</a>
+</th>
+</tr>
+<tr>
+<td valign="middle">Apache Software License Version 2.0</td>
+</tr>
+</tbody>
+</table>
+<table class="HdrButtons" align="center" border="1">
+<tbody>
+<tr>
+<td>
+<a href="http://www.apache.org">Apache Foundation</a>
+</td>
+<td>
+<a href="http://xalan.apache.org">Xalan Project</a>
+</td>
+<td>
+<a href="http://xerces.apache.org">Xerces Project</a>
+</td>
+<td>
+<a href="http://www.w3.org/TR">Web Consortium</a>
+</td>
+<td>
+<a href="http://www.oasis-open.org/standards">Oasis Open</a>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div id="navLeft">
+<ul>
+<li>
+<a href="resources.html">Resources</a>
+<br />
+</li>
+<li>
+<a href="../index.html">Home</a>
+</li></ul><hr /><ul>
+<li>
+<a href="index.html">Xalan-C++ 1.11</a>
+</li>
+<li>
+<a href="whatsnew.html">What's New</a>
+</li>
+<li>Licenses<br />
+</li></ul><hr /><ul>
+<li>
+<a href="overview.html">Overview</a>
+</li>
+<li>
+<a href="charter.html">Charter</a>
+</li></ul><hr /><ul>
+<li>
+<a href="download.html">Download</a>
+</li>
+<li>
+<a href="buildlibs.html">Build Libraries</a>
+</li>
+<li>
+<a href="install.html">Installation</a>
+</li>
+<li>
+<a href="builddocs.html">Build Documents</a>
+</li></ul><hr /><ul>
+<li>
+<a href="samples.html">Sample Apps</a>
+</li>
+<li>
+<a href="commandline.html">Command Line</a>
+</li>
+<li>
+<a href="usagepatterns.html">Usage Patterns</a>
+</li></ul><hr /><ul>
+<li>
+<a href="programming.html">Programming</a>
+</li>
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
+<li>
+<a href="extensionslib.html">Extensions Library</a>
+</li>
+<li>
+<a href="apiDocs/index.html">API Reference</a>
+</li></ul><hr /><ul>
+<li>
+<a href="faq.html">Xalan-C FAQs</a>
+</li></ul><hr /><ul>
+<li>
+<a href="whatsnew.html#bugs">Bugs</a>
+</li>
+<li>
+<a href="http://xml.apache.org/xalan-j/test/run.html#how-to-run-c">Testing</a>
+</li>
+<li>
+<a href="secureweb.html">Web Security</a>
+</li>
+</ul>
+</div>
+<div id="content">
+<h2>Apache Software License Version 2.0</h2>
+<ul>
+ <li>
+<a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License Version 2.0</a>
+</li>
+ <li>
+<a href="#notice">Xalan License Notice</a>
+</li>
+ <li>
+<a href="#license">Apache Software License Text</a>
+</li>
+</ul>
+<a name="notice">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Xalan Software License Notice</h3>
+<blockquote class="source">
+<pre> =======================================================================
+ == NOTICE file corresponding to section 4(d) of the Apache License. ==
+ == Version 2.0, in this case for the Apache Xalan distribution. ==
+ =======================================================================
+
+ Apache XALAN-C
+ Copyright (c) 1999-2012 The Apache Software Foundation
+
+ This product includes software developed at
+ The Apache Software Foundation (http://www.apache.org/).
+
+ This software is based on the ASF XERCES-C project.
+
+ Portions of this software were originally based on the following:
+ - software copyright (c) 1999, IBM Corporation. (http://www.ibm.com).
+
+ Additional copyright submissions and contributions:
+</pre>
+</blockquote>
+
+<a name="license">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Apache Software License Text</h3>
+<blockquote class="source">
+<pre> Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.</pre>
+</blockquote>
+
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+</div>
+<div id="footer">Copyright © 1999-2012 The Apache Software Foundation<br />Apache, Xalan, and the Feather logo are trademarks of The Apache Software Foundation<div class="small">Web Page created on - Fri 06/15/2012</div>
+</div>
+</body>
+</html>
Added: xalan/site/docs/xalan/xalan-c/options-include.gif
URL: http://svn.apache.org/viewvc/xalan/site/docs/xalan/xalan-c/options-include.gif?rev=1350856&view=auto
==============================================================================
Binary file - no diff available.
Propchange: xalan/site/docs/xalan/xalan-c/options-include.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: xalan/site/docs/xalan/xalan-c/options-sane.gif
URL: http://svn.apache.org/viewvc/xalan/site/docs/xalan/xalan-c/options-sane.gif?rev=1350856&view=auto
==============================================================================
Binary file - no diff available.
Propchange: xalan/site/docs/xalan/xalan-c/options-sane.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: xalan/site/docs/xalan/xalan-c/overview.html
URL: http://svn.apache.org/viewvc/xalan/site/docs/xalan/xalan-c/overview.html?rev=1350856&view=auto
==============================================================================
--- xalan/site/docs/xalan/xalan-c/overview.html (added)
+++ xalan/site/docs/xalan/xalan-c/overview.html Sat Jun 16 03:57:36 2012
@@ -0,0 +1,384 @@
+<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<head>
+<title>ASF: Xalan-C++ Overview</title>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<link rel="stylesheet" type="text/css" href="resources/apache-xalan.css" />
+</head>
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ -->
+<body>
+<div id="title">
+<table class="HdrTitle">
+<tbody>
+<tr>
+<th rowspan="2">
+<a href="../index.html">
+<img alt="Trademark Logo" src="resources/XalanC-Logo-tm.png" width="190" height="90" />
+</a>
+</th>
+<th text-align="center" width="75%">
+<a href="index.html">Xalan-C/C++ Version 1.11</a>
+</th>
+</tr>
+<tr>
+<td valign="middle">Xalan-C++ Overview</td>
+</tr>
+</tbody>
+</table>
+<table class="HdrButtons" align="center" border="1">
+<tbody>
+<tr>
+<td>
+<a href="http://www.apache.org">Apache Foundation</a>
+</td>
+<td>
+<a href="http://xalan.apache.org">Xalan Project</a>
+</td>
+<td>
+<a href="http://xerces.apache.org">Xerces Project</a>
+</td>
+<td>
+<a href="http://www.w3.org/TR">Web Consortium</a>
+</td>
+<td>
+<a href="http://www.oasis-open.org/standards">Oasis Open</a>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div id="navLeft">
+<ul>
+<li>
+<a href="resources.html">Resources</a>
+<br />
+</li>
+<li>
+<a href="../index.html">Home</a>
+</li></ul><hr /><ul>
+<li>
+<a href="index.html">Xalan-C++ 1.11</a>
+</li>
+<li>
+<a href="whatsnew.html">What's New</a>
+</li>
+<li>
+<a href="license.html">Licenses</a>
+</li></ul><hr /><ul>
+<li>Overview<br />
+</li>
+<li>
+<a href="charter.html">Charter</a>
+</li></ul><hr /><ul>
+<li>
+<a href="download.html">Download</a>
+</li>
+<li>
+<a href="buildlibs.html">Build Libraries</a>
+</li>
+<li>
+<a href="install.html">Installation</a>
+</li>
+<li>
+<a href="builddocs.html">Build Documents</a>
+</li></ul><hr /><ul>
+<li>
+<a href="samples.html">Sample Apps</a>
+</li>
+<li>
+<a href="commandline.html">Command Line</a>
+</li>
+<li>
+<a href="usagepatterns.html">Usage Patterns</a>
+</li></ul><hr /><ul>
+<li>
+<a href="programming.html">Programming</a>
+</li>
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
+<li>
+<a href="extensionslib.html">Extensions Library</a>
+</li>
+<li>
+<a href="apiDocs/index.html">API Reference</a>
+</li></ul><hr /><ul>
+<li>
+<a href="faq.html">Xalan-C FAQs</a>
+</li></ul><hr /><ul>
+<li>
+<a href="whatsnew.html#bugs">Bugs</a>
+</li>
+<li>
+<a href="http://xml.apache.org/xalan-j/test/run.html#how-to-run-c">Testing</a>
+</li>
+<li>
+<a href="secureweb.html">Web Security</a>
+</li>
+</ul>
+</div>
+<div id="content">
+<h2>Xalan-C++ Overview</h2>
+<ul>
+ <li>
+<a href="#intro">Introduction</a>
+</li>
+ <li>
+<a href="#features">Xalan-C++ Features</a>
+</li>
+ <li>
+<a href="#towork">Getting to work with Xalan-C++</a>
+</li>
+ <li>
+<a href="#uptospeed">Getting up to speed with XSLT</a>
+</li>
+ <li>
+<a href="#glossary">Glossary</a>
+</li>
+</ul>
+
+<a name="intro">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Introduction</h3>
+<p>Xalan-C++ (named after a rare musical instrument) implements the <a href="http://www.w3.org/TR/xslt">W3C Recommendation 16 November 1999 XSL Transformations (XSLT) Version 1.0</a> and the
+ <a href="http://www.w3.org/TR/xpath">XML Path Language (XPath) Version 1.0</a>. XSLT is the first part of the XSL stylesheet language for XML. It includes the XSL
+ Transformation vocabulary and XPath, a language for addressing parts of XML documents. For links to background materials,
+ discussion groups, frequently asked questions, and tutorials on XSLT, see <a href="#uptospeed">Getting up to speed with
+ XSLT</a>.</p>
+<table class="note">
+<tr>
+<td class="noteImg">
+<img src="resources/note.gif" alt="note" />
+</td>
+<td class="noteTxt">XSL also includes a vocabulary for formatting documents, which is not part of Xalan-C++. For more information, see
+ <a href="http://www.w3.org/TR/xsl">Extensible Stylesheet Language (XSL) Version 1.0 W3C Recommendation</a> and the <a href="http://xml.apache.org/fop">Apache XML FOP (Formatting Objects Project)
+ </a>.
+</td>
+</tr>
+</table>
+<p>You use the XSLT language to compose XSL stylesheets. An XSL stylesheet contains instructions for transforming XML documents
+ from one document type to another document type (XML, HTML, or other). In structural terms, an XSL stylesheet specifies the
+ transformation of one tree of nodes (the XML input) into another tree of nodes (the output or transformation result).</p>
+<table class="note">
+<tr>
+<td class="noteImg">
+<img src="resources/note.gif" alt="note" />
+</td>
+<td class="noteTxt">The XSL stylesheet may generate and refer to cascading style sheets (<a href="http://www.w3.org/Style/CSS/">CSS</a>)
+ as part of its output.
+</td>
+</tr>
+</table>
+<p>In the following example, the foo.xsl stylesheet is used to transform foo.xml into foo.out:</p>
+<p>foo.xml:</p>
+<blockquote class="source">
+<pre>
+<?xml version="1.0"?>
+<doc>Hello</doc>
+</pre>
+</blockquote>
+<p>foo.xsl:</p>
+<blockquote class="source">
+<pre>
+<?xml version="1.0"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+<xsl:template match="doc">
+<out><xsl:value-of select="."/></out>
+</xsl:template>
+</xsl:stylesheet>
+</pre>
+</blockquote>
+<p>foo.out:</p>
+<blockquote class="source">
+<pre><out>Hello</out></pre>
+</blockquote>
+
+<a name="features">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Xalan-C++ Features</h3>
+<ul>
+ <li>Xalan-C++ fully implements the <a href="http://www.w3.org/TR/xslt">W3C Recommendation 16 November 1999 XSL Transformations (XSLT) Version 1.0</a>.</li>
+ <li>Xalan-C++ incorporates the <a href="http://www.w3.org/TR/xpath">XML Path Language (XPath) Version 1.0</a>.<br />
+<br />
+</li>
+ <li>Xalan-C++ uses <a href="http://xml.apache.org/xerces-c/index.html">Xerces-C++</a> to parse XML documents and XSL
+ stylesheets.<br />
+<br />
+ The input may appear in the form of a file or URL, a stream, or a <a href="http://www.w3.org/DOM">DOM</a>.
+ Xalan-C++ performs the transformations specified in the XSL stylesheet and produces a file, a stream, or a DOM as you
+ specify when you set up the transformation.<br />
+<br />
+</li>
+ <li>Along with a complete API for performing transformations in your C++ applications, Xalan-C++ provides a <a href="commandline.html">command line</a> utility for convenient file-to-file transformations.<br />
+<br />
+</li>
+ <li>Xalan-C++ supports C++ <a href="extensions.html">extension functions</a>
+</li>
+</ul>
+
+
+<a name="towork">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Getting to work with Xalan-C++</h3>
+<p>For instructions and some suggestions about how to get started using Xalan-C++, see <a href="download.html">Downloading Xalan-C++</a>,
+ <a href="buildlibs.html">Building Xalan-C++</a>, and <a href="install.html">Installing Xalan-C++</a>.</p>
+
+
+<a name="uptospeed">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Getting up to speed with XSLT</h3>
+<p>If you are still working through the details of the XSLT spec (the W3C 1.0 Recommendation), you may want
+ to consult one or more of the following:</p>
+ <ul>
+ <li>Crane Softwright's <a href="http://www.CraneSoftwrights.com/training/">Free preview of Practical
+ Transformation Using XSLT and XPath</a>
+<br />
+<br />
+</li>
+ <li>Doug Tidwell's <a href="http://www.oreilly.com/catalog/xslt/">XSLT</a>, O'Reilly, 2001<br />
+<br /> </li>
+ <li>Bob DuCharme's <a href="http://www.manning.com/ducharme/index.html">XSLT Quickly</a>, Manning Publications,
+ 2001<br />
+<br />
+</li>
+ <li>John Robert Gardner and Zarella Rendon's
+ <a href="http://vig.prenhall.com/catalog/academic/product/1,4096,0130404462,00.html">XSLT and XPath: A Guide to
+ Transformations</a>, Prentice-Hall, 2001<br />
+<br />
+</li>
+
+
+ <li>Elliotte Rusty Harold's <a href="http://www.ibiblio.org/xml/books/bible2/chapters/ch17.html">Chapter 17 of
+ the XML Bible: XSL Transformations</a>
+<br />
+<br />
+</li>
+ <li>The Mulberry <a href="http://www.mulberrytech.com/xsl/xsl-list/">XSL-List -- Open Forum on XSL</a>
+ (of interest to XSL users at all levels)<br />
+<br />
+</li>
+ <li>Objects by Design's <a href="http://www.objectsbydesign.com/projects/xmi_to_html.html">Transforming XMI to
+ HTML</a> (oriented towards XMI, "an XML-based, stream representation of a UML model," but also covers "generic"
+ XML transformations) and their related <a href="http://objectsbydesign.com/projects/xslt/xslt_by_example.html">XSLT
+ by Example</a>
+<br />
+<br />
+</li>
+
+ <li>OASIS (the Organization for the Advancement of Structured Information Standards):
+ <a href="http://www.oasis-open.org/cover/xsl.html">Extensible Stylesheet Language (XSL)</a> by Robin
+ Cover<br />
+<br />
+</li>
+ <li>Aaron Skonnard and Martin Gudgin's
+<a href="http://www.theserverside.net/tt/books/addisonwesley/EssentialXML/index.tss">Essential
+XML Quick Reference:</a> A Programmer's Reference to
+XML, XPath, XSLT, XML Schema, SOAP and More. This reference is published by Addison Wesley, 2003, ISBN/0201740958.<br />
+<br />
+</li>
+
+ </ul>
+<p>When you come across other useful introductory or background materials, please email <a href="mailto:xalan-dev@xml.apache.org">Xalan Development Mailing List</a>, so we can add them to this list.</p>
+
+
+
+<a name="glossary">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Glossary</h3>
+<div class="glossary">
+ <p class="label">
+<em>XSLT Namespace</em>
+</p>
+ <blockquote class="item">The <a href="http://www.w3.org/TR/REC-xml-names/">XML namespace</a> for XSLT. An XML namespace is a
+ collection of element and attribute names, identified by a Unique Resource Identifier (URI), which often takes
+ the form of a URL, but is really just a unique string, not a pointer to a web page. The XSLT namespace URI is
+ http://www.w3.org/1999/XSL/Transform. In each XSLT stylesheet, you must declare this namespace in the stylesheet
+ element tag and bind it to a local prefix. Like the XSLT specification, we always use xsl as the XSLT namespace
+ prefix in our descriptions and examples, although you are free to bind any prefix to this namespace.<br />
+<br />
+</blockquote>
+
+ <p class="label">
+<em>XSL Instruction</em>
+</p>
+ <blockquote class="item">Any tag associated with the XSLT namespace.<br />
+<br />
+</blockquote>
+
+ <p class="label">
+<em>Template</em>
+</p>
+ <blockquote class="item">An element, usually with child elements, that specifies a "rule" or set of instructions to perform when a
+ particular kind of node is encountered in the source tree.<br />
+<br />
+</blockquote>
+
+ <p class="label">
+<em>XSL Template Instruction</em>
+</p>
+ <blockquote class="item">Any tag that occurs inside an xsl:template element and is associated with the XSLT namespace.<br />
+<br />
+</blockquote>
+
+ <p class="label">
+<em>Source Tree</em>
+</p>
+ <blockquote class="item">The XML tree input to the XSL process.<br />
+<br />
+</blockquote>
+
+ <p class="label">
+<em>Result Tree</em>
+</p>
+ <blockquote class="item">The tree that is output by the XSL process.<br />
+<br />
+</blockquote>
+
+ <p class="label">
+<em>Match Pattern</em>
+</p>
+ <blockquote class="item">The part of a template that defines the kind(s) of nodes to which the template applies.<br />
+<br />
+</blockquote>
+
+</div>
+<p>For more definitions of XSLT terminology, see Dave Pawson's <a href="http://www.dpawson.co.uk/xsl/xslvocab.html">XSLT
+ Terminology Clarification</a> and the Glossary in Michael Kay's
+ <a href="http://www.wrox.com/Consumer/Store/Details.asp?ISBN=1861003129">XSLT Programmer's Reference</a>.</p>
+
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+</div>
+<div id="footer">Copyright © 1999-2012 The Apache Software Foundation<br />Apache, Xalan, and the Feather logo are trademarks of The Apache Software Foundation<div class="small">Web Page created on - Fri 06/15/2012</div>
+</div>
+</body>
+</html>
Added: xalan/site/docs/xalan/xalan-c/programming.html
URL: http://svn.apache.org/viewvc/xalan/site/docs/xalan/xalan-c/programming.html?rev=1350856&view=auto
==============================================================================
--- xalan/site/docs/xalan/xalan-c/programming.html (added)
+++ xalan/site/docs/xalan/xalan-c/programming.html Sat Jun 16 03:57:36 2012
@@ -0,0 +1,247 @@
+<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<head>
+<title>ASF: Programming Tips</title>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
+<meta http-equiv="Content-Style-Type" content="text/css" />
+<link rel="stylesheet" type="text/css" href="resources/apache-xalan.css" />
+</head>
+<!--
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ -->
+<body>
+<div id="title">
+<table class="HdrTitle">
+<tbody>
+<tr>
+<th rowspan="2">
+<a href="../index.html">
+<img alt="Trademark Logo" src="resources/XalanC-Logo-tm.png" width="190" height="90" />
+</a>
+</th>
+<th text-align="center" width="75%">
+<a href="index.html">Xalan-C/C++ Version 1.11</a>
+</th>
+</tr>
+<tr>
+<td valign="middle">Programming Tips</td>
+</tr>
+</tbody>
+</table>
+<table class="HdrButtons" align="center" border="1">
+<tbody>
+<tr>
+<td>
+<a href="http://www.apache.org">Apache Foundation</a>
+</td>
+<td>
+<a href="http://xalan.apache.org">Xalan Project</a>
+</td>
+<td>
+<a href="http://xerces.apache.org">Xerces Project</a>
+</td>
+<td>
+<a href="http://www.w3.org/TR">Web Consortium</a>
+</td>
+<td>
+<a href="http://www.oasis-open.org/standards">Oasis Open</a>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div id="navLeft">
+<ul>
+<li>
+<a href="resources.html">Resources</a>
+<br />
+</li>
+<li>
+<a href="../index.html">Home</a>
+</li></ul><hr /><ul>
+<li>
+<a href="index.html">Xalan-C++ 1.11</a>
+</li>
+<li>
+<a href="whatsnew.html">What's New</a>
+</li>
+<li>
+<a href="license.html">Licenses</a>
+</li></ul><hr /><ul>
+<li>
+<a href="overview.html">Overview</a>
+</li>
+<li>
+<a href="charter.html">Charter</a>
+</li></ul><hr /><ul>
+<li>
+<a href="download.html">Download</a>
+</li>
+<li>
+<a href="buildlibs.html">Build Libraries</a>
+</li>
+<li>
+<a href="install.html">Installation</a>
+</li>
+<li>
+<a href="builddocs.html">Build Documents</a>
+</li></ul><hr /><ul>
+<li>
+<a href="samples.html">Sample Apps</a>
+</li>
+<li>
+<a href="commandline.html">Command Line</a>
+</li>
+<li>
+<a href="usagepatterns.html">Usage Patterns</a>
+</li></ul><hr /><ul>
+<li>Programming<br />
+</li>
+<li>
+<a href="extensions.html">Extensions</a>
+</li>
+<li>
+<a href="extensionslib.html">Extensions Library</a>
+</li>
+<li>
+<a href="apiDocs/index.html">API Reference</a>
+</li></ul><hr /><ul>
+<li>
+<a href="faq.html">Xalan-C FAQs</a>
+</li></ul><hr /><ul>
+<li>
+<a href="whatsnew.html#bugs">Bugs</a>
+</li>
+<li>
+<a href="http://xml.apache.org/xalan-j/test/run.html#how-to-run-c">Testing</a>
+</li>
+<li>
+<a href="secureweb.html">Web Security</a>
+</li>
+</ul>
+</div>
+<div id="content">
+<h2>Programming Tips</h2>
+ <ul>
+ <li>
+<a href="#intro">Introduction</a>
+</li>
+ <li>
+<a href="#memory">Pluggable Memory Management</a>
+</li>
+ <li>
+<a href="#more">More topics</a>
+</li>
+ </ul>
+
+<a name="intro">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Introduction</h3>
+<p>This section was created to guide users on how to use some of the new features going into the Xalan
+source code base. Some of the features discussed in this section are based on feedback and questions
+posted on the xalan-c-users newsgroup. This section will cover the benefits of certain features
+and provide users with programming hints on how to utilize the features in their applications.</p>
+
+
+<a name="memory">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>Pluggable Memory Management</h3>
+<p>Pluggable memory management was added as a new feature in Xalan-C Version 1.8;. This feature introduces an
+object called MemoryManager which allows applications with stricter memory management requirements to
+utilize a more efficient allocation method. This MemoryManager object can be applied to
+each processor instance, thus recovery procedures from memory leaks or processor crashes will be applied to
+the associated instance only.</p>
+<p>The memory management model is similar to the memory management feature provided by the Xerces-C XML Parser.</p>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h4>How To Use This Feature</h4>
+<p>To apply memory management to your application, the MemoryManager object needs to be specified in two
+stages:</p>
+<ul>
+<li>At initialization phase. The purpose of specifying a MemoryManager object during initialization is to
+create a separate memory manager for the overall application. Example of how this can be done is shown in
+the example below<br />
+<br />
+<blockquote class="source">
+<pre>
+// Initialization step
+static void XalanTransformer::initialize(MemoryManager* initMemoryManager=0);
+</pre>
+</blockquote>
+</li>
+<li>Creation of a transformer instance. This creates a unique memory manager for the instance of the
+processor. This step is optional. If no memory manager is provided, the global heap is used as the memory
+source. Example of this is shown below:<br />
+<br />
+<blockquote class="source">
+<pre>
+// Create instance of XalanTransformer
+MemoryManager memMgrA; // memory manager object
+XalanTransformer transformerA(&memMgrA);
+
+MemoryManager memMgrB;
+XalanTransformer transformerB(&memMgrB);
+XalanTransformer transformerC(&memMgrB); // Uses same memory manager object as transformerB
+XalanTransformer transformerD; // Uses default static memory manager
+</pre>
+</blockquote>
+</li>
+</ul>
+<p>The above method demonstrates how users can apply the basic pluggable memory management feature. Users
+also have the option of implementing their own memory manager. This can be done by simply writing methods
+for:</p>
+<blockquote class="source">
+<pre>
+// Method for allocating memory
+void* allocate(size_t size);
+</pre>
+</blockquote>
+<p>and</p>
+<blockquote class="source">
+<pre>
+// Method for deallocating memory
+void deallocate(void *p);
+</pre>
+</blockquote>
+<p>For an example of how to use this feature, please see the <a href="samples.html#simpletransform">
+SimpleTransform</a> sample that has been provided in the binary distributions.</p>
+
+
+
+<a name="more">‌</a>
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+<h3>More Topics</h3>
+<p>Please feel free to give us feedback on what topics you would like to see.</p>
+<p>Send comments to <a href="mailto:xalan-dev@xml.apache.org">Xalan Development Mailing List</a>.</p>
+
+
+<p align="right" size="2">
+<a href="#content">(top)</a>
+</p>
+</div>
+<div id="footer">Copyright © 1999-2012 The Apache Software Foundation<br />Apache, Xalan, and the Feather logo are trademarks of The Apache Software Foundation<div class="small">Web Page created on - Fri 06/15/2012</div>
+</div>
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org