You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by mc...@apache.org on 2005/07/19 19:36:22 UTC

cvs commit: xml-xalan/java/xdocs/sources entities.src xalan-jsite.xml xalan-jlocal.xml

mcnamara    2005/07/19 10:36:21

  Modified:    java/xdocs/sources xalan-jsite.xml xalan-jlocal.xml
  Added:       java/xdocs/sources entities.src
  Log:
  Doc changes for Xalan Java 2.7.0 release.
  This change was reviewed and approved in XALANJ-2170 by Christine Li.
  
  Revision  Changes    Path
  1.60      +13 -20    xml-xalan/java/xdocs/sources/xalan-jsite.xml
  
  Index: xalan-jsite.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan-jsite.xml,v
  retrieving revision 1.59
  retrieving revision 1.60
  diff -u -r1.59 -r1.60
  --- xalan-jsite.xml	15 Jun 2005 15:16:15 -0000	1.59
  +++ xalan-jsite.xml	19 Jul 2005 17:36:20 -0000	1.60
  @@ -18,14 +18,12 @@
   -->
   <!-- $Id$ -->
   
  -<book title="Xalan XSL Transformer User's Guide" copyright="2004 The Apache Software Foundation">
  +<book title="Xalan XSL Transformer User's Guide" copyright="2005 The Apache Software Foundation">
     <resources source="sbk:/sources/xalan/resources.xml"/>
     <external href="../index.html" label="Home"/>
     <separator/>
  -  <document id="index" label="Xalan-J 2.6.0" source="xalan/index.xml"/>
  -<!--  Commenting this out for now.  We have info in the Release Notes that discusses 
  -      changes in the release.
  -  <document id="whatsnew" label="What's New" source="xalan/whatsnew.xml"/> -->
  +  <document id="index" label="Xalan-J 2.7.0" source="xalan/index.xml"/>
  +  <document id="whatsnew" label="What's New" source="xalan/whatsnew.xml"/>
     <separator/>
     <document id="overview" label="Overview" source="xalan/overview.xml"/>
     <document id="downloads" label="Downloads" source="xalan/downloads.xml"/>  
  @@ -36,34 +34,29 @@
     <separator/>
     <document id="samples" label="Sample Apps" source="xalan/samples.xml"/>
     <document id="commandline" label="Command Line" source="xalan/commandline.xml"/>
  -  <hidden id="commandline_xsltc" source="xalan/commandline_xsltc.xml"/>  
  +  <hidden   id="commandline_xsltc" source="xalan/commandline_xsltc.xml"/>  
     <separator/>
  -  <document id="usagepatterns" label="Usage Patterns" source="xalan/usagepatterns.xml"/>
     <document id="features" label="Features" source="xalan/features.xml"/>
  -  <separator/>
  -  <document id="trax" label="TrAX" source="xalan/trax.xml"/>
  +  <document id="trax" label="Transform API" source="xalan/trax.xml"/>
     <document id="xpath_apis" label="XPath API" source="xalan/xpath_apis.xml"/>
  -  <document id="dtm" label="DTM" source="xalan/dtm.xml"/>  
  -  <document id="public_apis" label="Public API's"
  -            source="xalan/public_apis.xml"/>
  -  <external href="apidocs/index.html" label="API (Javadoc)"/>
  +  <document id="usagepatterns" label="Usage Patterns" source="xalan/usagepatterns.xml"/>
     <separator/>
  +  <external href="apidocs/index.html" label="Xalan-J API"/>    
  +  <document id="public_apis" label="Public APIs" source="xalan/public_apis.xml"/>
  +  <document id="dtm" label="DTM" source="xalan/dtm.xml"/>   
  +  <separator/>    
     <document id="extensions" label="Extensions" source="xalan/extensions.xml"/>
     <document id="extensionslib" label="Extensions Library" source="xalan/extensionslib.xml"/>
     <document id="extensions_xsltc" label="XSLTC Exts" source="xalan/extensions_xsltc.xml"/>
     <separator/>
     <document id="readme" label="Release Notes" source="xalan/readme.xml"/>
     <document id="builds" label="Xalan-Java Builds" source="xalan/builds.xml"/>
  -  <hidden id="history" source="xalan/history.xml"/>
  -  <hidden id="xsltc_history" source="xalan/xsltc_history.xml"/>
  +  <hidden   id="history" source="xalan/history.xml"/>
  +  <hidden   id="xsltc_history" source="xalan/xsltc_history.xml"/>
     <separator/>
     <external href="design/design2_0_0.html" label="Xalan 2 Design"/>
     <external href="xsltc/index.html" label="XSLTC Design"/>  
     <separator/>
     <external href="readme.html#bugs" label="Bugs"/>  
     <external href="http://xml.apache.org/xalan-j/test/overview.html" label="Testing"/>
  -<!--  Temporarily commenting this section out.  We need to overhaul the list.
  -  <separator/>
  -  <external href="readme.html#developer-list" label="Credits"/>
  -  <external href="xsltc/todo.html#developer-list" label="XSLTC Credits"/> -->
   </book>
  
  
  
  1.33      +10 -17    xml-xalan/java/xdocs/sources/xalan-jlocal.xml
  
  Index: xalan-jlocal.xml
  ===================================================================
  RCS file: /home/cvs/xml-xalan/java/xdocs/sources/xalan-jlocal.xml,v
  retrieving revision 1.32
  retrieving revision 1.33
  diff -u -r1.32 -r1.33
  --- xalan-jlocal.xml	15 Jun 2005 15:16:15 -0000	1.32
  +++ xalan-jlocal.xml	19 Jul 2005 17:36:20 -0000	1.33
  @@ -18,12 +18,10 @@
   -->
   <!-- $Id$ -->
   
  -<book title="Xalan XSL Transformer User's Guide" copyright="2004 The Apache Software Foundation">
  +<book title="Xalan XSL Transformer User's Guide" copyright="2005 The Apache Software Foundation">
     <resources source="sbk:/sources/xalan/resources.xml"/>
  -<!--  Commenting this out for now.  We have info in the Release Notes that discusses 
  -      changes in the release.
     <document id="whatsnew" label="What's New" source="xalan/whatsnew.xml"/>
  -  <separator/> -->
  +  <separator/>
     <document id="overview" label="Overview" source="xalan/overview.xml"/>
     <document id="downloads" label="Downloads" source="xalan/downloads.xml"/>  
     <document id="getstarted" label="Getting Started" source="xalan/getstarted.xml"/>
  @@ -35,23 +33,22 @@
     <document id="commandline" label="Command Line" source="xalan/commandline.xml"/>
     <hidden   id="commandline_xsltc" source="xalan/commandline_xsltc.xml"/>  
     <separator/>
  -  <document id="usagepatterns" label="Usage Patterns" source="xalan/usagepatterns.xml"/>
     <document id="features" label="Features" source="xalan/features.xml"/>
  -  <separator/>
  -  <document id="trax" label="TrAX" source="xalan/trax.xml"/>
  +  <document id="trax" label="Transform API" source="xalan/trax.xml"/>
     <document id="xpath_apis" label="XPath API" source="xalan/xpath_apis.xml"/>
  +  <document id="usagepatterns" label="Usage Patterns" source="xalan/usagepatterns.xml"/>
  +  <separator/>
  +  <external href="apidocs/index.html" label="Xalan-J API"/>    
  +  <document id="public_apis" label="Public APIs" source="xalan/public_apis.xml"/>
     <document id="dtm" label="DTM" source="xalan/dtm.xml"/>  
  -  <document id="public_apis" label="Public API's"
  -            source="xalan/public_apis.xml"/>  
  -  <external href="apidocs/index.html" label="API (Javadoc)"/>
     <separator/>
     <document id="extensions" label="Extensions" source="xalan/extensions.xml"/>
     <document id="extensionslib" label="Extensions Library" source="xalan/extensionslib.xml"/>
     <document id="extensions_xsltc" label="XSLTC Exts" source="xalan/extensions_xsltc.xml"/>
     <separator/>
     <document id="readme" label="Release Notes" source="xalan/readme.xml"/>
  -  <hidden id="history" source="xalan/history.xml"/>
  -  <hidden id="xsltc_history" source="xalan/xsltc_history.xml"/>
  +  <hidden   id="history" source="xalan/history.xml"/>
  +  <hidden   id="xsltc_history" source="xalan/xsltc_history.xml"/>
     <separator/>
     <external href="design/design2_0_0.html" label="Xalan 2 Design"/>
     <external href="xsltc/index.html" label="XSLTC Design"/>
  @@ -59,8 +56,4 @@
     <external href="readme.html#bugs" label="Bugs"/>
     <external href="http://xml.apache.org/xalan-j/test/overview.html" label="Testing"/>
     <document id="builds" label="Builds" source="xalan/builds.xml"/>
  -<!-- Temporarily commenting this section out.  We need to overhaul the list.
  -  <separator/>
  -  <external href="readme.html#developer-list" label="Credits"/>
  -  <external href="xsltc/todo.html#developer-list" label="XSLTC Credits"/>  -->
   </book>
  
  
  
  1.1                  xml-xalan/java/xdocs/sources/entities.src
  
  Index: entities.src
  ===================================================================
  <?xml encoding="US-ASCII"?>
  
  <!ENTITY xslt "Xalan">
  <!ENTITY xslt4j "Xalan-Java">
  <!ENTITY xslt4j2 "Xalan-Java 2">
  <!ENTITY xslt4ji "&xslt4j; Interpretive">
  <!ENTITY xslt4jc-short "XSLTC">
  <!ENTITY xslt4jc-long  "&xslt4j; Compiled">
  <!ENTITY xslt4j-dist-bin "&xslt4j-dist;-bin">
  <!ENTITY xslt4j-dist-src "&xslt4j-dist;-src">
  <!ENTITY xslt4j-dist "xalan-j_@version.VERSION@_@version.RELEASE@_@version.MINOR@">
  <!ENTITY xslt4j-current "&xslt4j; Version @version.VERSION@.@version.RELEASE@.@version.MINOR@">
  <!ENTITY xslt4j-distdir "http://www.apache.org/dyn/closer.cgi/xml/xalan-j/">
  <!ENTITY xslt4j_longname "Apache Xalan Java">
  <!ENTITY xml4j "Xerces-Java">
  <!ENTITY xml4j1 "Xerces-Java 1">
  <!ENTITY xml4j2 "Xerces-Java 2">
  <!ENTITY xml4j-used "&xml4j; @parser.version.VERSION@.@parser.version.RELEASE@.@parser.version.MINOR@">
  <!ENTITY xml4j-jar "xercesImpl.jar">
  <!ENTITY xslt4c "Xalan-C++">
  <!ENTITY xml4c "Xerces-C++">
  <!ENTITY jaxp13-short "JAXP 1.3">
  <!ENTITY jaxp13-long  "Java API for XML Processing (JAXP) 1.3">
  <!ENTITY download "The &xslt4j-current; download includes &xml4j-jar; from &xml4j-used; and xml-apis.jar. 
  For version information about the contents of xml-apis.jar, see the JAR manifest.">
  
  <!ENTITY xsltcwhatsnewhead '<li><link anchor="xsltc">&xslt4jc-short;</link></li>'>
  
  <!ENTITY xsltcwhatsnew '<anchor name="xsltc"/><s2 title="&xslt4jc-long; (&xslt4jc-short;)">
                  <p>In April 2001, Sun donated &xslt4jc-short; to the Xalan project. &xslt4jc-short; compiles stylesheets into translets and
                  provides a runtime environment for using translets to transform XML documents. Initially, &xslt4jc-short; is
                  available in a separate JAR. Over time, we plan to integrate the two codebases. For more information,
                  see <link idref="xsltc_usage">Getting Started with &xslt4jc-short;</link>, 
                  <link idref="readme" anchor="xsltcreleasenotes">&xslt4jc-short;
                  Release Notes</link>, and <jump href="xsltc/index.html">&xslt4jc-short; Design</link>.</p>
                  </s2>'>
  
  <!ENTITY history2xsltc '<note>For &xslt4jc-short; changes since &xslt4jc-short; was incorporated into &xslt4j;, see
                          <link idref="xsltc_history">&xslt4jc-short; software changes</link>.</note>'>
  
  <!ENTITY xsltcclasspath '<p>If you are using <link idref="xsltc_usage">&xslt4jc-short;</link>, see
                          <link idref="xsltc_usage" anchor="classpath">Setting the system classpath for &xslt4jc-short;</link>.</p>'>
  
  <!ENTITY xsltcsampleshead '<li><link anchor="translets">translets</link></li>'>
  
  <!ENTITY xsltcsamples '<anchor name="translets"/><s2 title="Translets">
                   <ul>
                   <li><link anchor="xsltc1">JAXPTransletOneTransformation</link></li>
                   <li><link anchor="xsltc2">JAXPTransletMultipleTransformations</link></li>
                   <li><link anchor="xsltcother">Other &xslt4jc-short; samples</link></li>   
                   </ul>
                   <p>You can use the JAXP interfaces to compile and run translets.
                   For an overview of the usage patterns these samples illustrate, see 
                   <link idref="xsltc_usage" anchor="api">Calling &xslt4jc-short; with the JAXP API</link>.</p>
                   <anchor name="xsltc1"/>
                   <s3 title="JAXPTransletOneTransformation">
                   <p>What it does: Uses the &xslt4jc-short; TransformerFactory to compile a translet and use
                   the translet to transform the &xslt4jc-short; to-do list from XML into HTML.</p>
                   <p>Run this sample from the translets subdirectory with</p>
                   <p><code>java JAXPTransletOneTransformation</code></p>
                   <p>View the result in todo.html.</p>
                   </s3><anchor name="xsltc2"/>
                   <s3 title="JAXPTransletMultipleTransformations">
                   <p>What it does: Uses the &xslt4jc-short; TransformerFactory to compile a translet and use
                   the Templates object associated with the translet to transform the &xslt4jc-short; and Xalan to-do lists from XML 
                   into HTML.</p>
                   <p>Run this sample from the translets subdirectory with</p>
                   <p><code>java JAXPTransletMultipleTransformations</code></p>
                   <p>View the results in todo.html and todotoo.html.</p>                
                   </s3><anchor name="xsltcother"/>
                   <s3 title="Other &xslt4jc-short; samples">
                   <p>Other &xslt4jc-short; samples are located in the following samples subdirectories:</p>
                   <ul>
                   <li>CompiledServlet</li>
                   <li>CompiledBrazil</li>
                   <li>CompiledJAXP</li>
                   <li>CompiledApplet</li>
                   <li>CompiledEJB</li>
                   </ul>
                   <p>For information about each of these samples, consult the README file in the subdirectory.</p>
                   <p>&xslt4jc-short; provides demos for using &xslt4jc-short; as a servlet and as a handler for
                   Brazil (a new and powerful Web techology from Sun labs).</p>
                   <p>To run the Brazil-handler demo, download Brazil from sunlabs:</p>
                   <p><code>&nbsp;&nbsp;&nbsp;&nbsp;<jump href="http://research.sun.com/research/download/index.html">http://research.sun.com/research/download/index.html</jump></code></p>
                   <p>The translet must be specified as a pure class name,
                   accessible through the Brazil-handler&apos;s classpath. For
                   example:</p>
                   <p><code>&nbsp;&nbsp;&nbsp;&nbsp;translet=mk054</code></p>
                   <p>The document must be specified as a valid URL. For example:</p>
                   <p><code>&nbsp;&nbsp;&nbsp;&nbsp;document=http://server/path/to/filename.xml</code></p>
                   <p>If the file is local to the Brazil handler, it has to be
                  specified using the "file:filename.xml" format.</p>
                  <note>In order to run the Brazil-handler demo, you also need to
                        make the Brazil and javax classes available from your
                        classpath</note>
                   <p>To run the servlet demo, download the java extensions for servlets from Sun:</p>
                   <p><code>&nbsp;&nbsp;&nbsp;&nbsp;
                   <jump href="http://java.sun.com/products/servlet/download.html">
                   http://java.sun.com/products/servlet/download.html</jump></code></p>
                   </s3>
                   </s2>'>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org