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/...
[email protected] Sat, 16 Jun 2012 03:57:39 -0000
| Newsgroups | gmane.text.xml.xalan.cvs |
|---|---|
| Message-ID | <[email protected]> |
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:[email protected]">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:[email protected]">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:[email protected]">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:[email protected]">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:[email protected]">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:[email protected]">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>