morrijr 02/05/25 08:32:00
Modified: . build.xml changes.xml
lib jars.xml
src/documentation/xdocs/installing jars.xml
tools/src check-jars.xsl
Log:
Dynamically create documentation/installation/jars.xml
Revision Changes Path
1.218 +1 -1 xml-cocoon2/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/build.xml,v
retrieving revision 1.217
retrieving revision 1.218
diff -u -r1.217 -r1.218
--- build.xml 24 May 2002 17:40:30 -0000 1.217
+++ build.xml 25 May 2002 15:32:00 -0000 1.218
@@ -1831,7 +1831,7 @@
<replace file="${build.dir}/current-jars.xml"
token="${file.separator}" value="/"/>
- <style in="${lib.dir}/jars.xml" out="${build.dir}/unknown.xml"
+ <style in="${lib.dir}/jars.xml" out="${build.dir}/jars.xml"
processor="trax"
style="${tools.dir}/src/check-jars.xsl">
<param name="current-files"
1.172 +7 -1 xml-cocoon2/changes.xml
Index: changes.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/changes.xml,v
retrieving revision 1.171
retrieving revision 1.172
diff -u -r1.171 -r1.172
--- changes.xml 25 May 2002 15:26:23 -0000 1.171
+++ changes.xml 25 May 2002 15:32:00 -0000 1.172
@@ -4,7 +4,7 @@
<!--
History of Cocoon changes
- $Id: changes.xml,v 1.171 2002/05/25 15:26:23 froehlich Exp $
+ $Id: changes.xml,v 1.172 2002/05/25 15:32:00 morrijr Exp $
-->
<changes title="History of Changes">
@@ -38,6 +38,12 @@
</devs>
<release version="@version@" date="@date@">
+ <action dev="JM" type="add">
+ Modified check-jars.xsl to dynamically create the jars.xml for
+ documentation.
+ Need to copy the generated file over the static placeholder...
+ Help - where to in the build.xml?
+ </action>
<action dev="GF" type="add" due-to="Stephan Michels"
due-to-email="[EMAIL PROTECTED]">
ResourceReader gets the mime type from the source now,
instead of declaring the mime type in the sitemap.
1.4 +255 -113 xml-cocoon2/lib/jars.xml
Index: jars.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/lib/jars.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- jars.xml 24 May 2002 16:33:55 -0000 1.3
+++ jars.xml 25 May 2002 15:32:00 -0000 1.4
@@ -10,118 +10,260 @@
-->
<jars>
- <file description="Avalon Excalibur" used-by="Cocoon">
- core/avalon-excalibur-20020506.jar
+ <file>
+ <title>Avalon Excalibur</title>
+ <description>Part of jakarta-avalon, it is a set of classes and patterns that
+ support high level server development.</description>
+ <used-by>Cocoon</used-by>
+ <lib>core/avalon-excalibur-20020506.jar</lib>
+ <homepage>http://jakarta.apache.org/avalon/excalibur/</homepage>
+ </file>
+ <file>
+ <title>Avalon Framework</title>
+ <description>Part of jakarta-avalon, it is a set of classes and patterns that
+ support high level server development.</description>
+ <used-by>Cocoon</used-by>
+ <lib>core/avalon-framework-4.1.2.jar</lib>
+ <homepage>http://jakarta.apache.org/avalon/framework/</homepage>
+ </file>
+ <file>
+ <title>Jakarta Commons Collections</title>
+ <description>Common implementations of collection classes.</description>
+ <used-by>Cocoon</used-by>
+ <lib>core/commons-collections-1.0.jar</lib>
+ <homepage>http://jakarta.apache.org/commons/collections.html</homepage>
+ </file>
+ <file>
+ <title>Jakart Commons httpClient</title>
+ <description>Although the java.net package provides basic support for accessing
+ resources via HTTP, it doesn't provide the full flexibility or
+ functionality needed by many applications. The Jakarta Commons HTTP Client
+ component seeks to fill this void by providing an efficient, up-to-date,
+ and feature-rich package implementing the client side of the most recent
+ HTTP standards and recommendations.</description>
+ <used-by>SOAP logicsheet</used-by>
+ <lib>core/commons-httpclient-20020423.jar</lib>
+ <homepage>http://jakarta.apache.org/commons/httpclient/</homepage>
+ </file>
+ <file>
+ <title>Jakarta Regexp</title>
+ <description>Regexp is a Java Regular Expression package that was graciously
+ donated to the Apache Software Foundation by Jonathan Locke.</description>
+ <used-by>sitemap matchers</used-by>
+ <lib>core/jakarta-regexp-1.2.jar</lib>
+ <homepage>http://jakarta.apache.org/regexp/</homepage>
+ </file>
+ <file>
+ <title>Jakarta logkit</title>
+ <description>jakarta-avalon-logkit is a logging toolkit designed for secure
+ performance orientated logging in applications.</description>
+ <used-by>Cocoon logging</used-by>
+ <lib>core/logkit-1.0.1.jar</lib>
+ <homepage>http://jakarta.apache.org/avalon/logkit/</homepage>
+ </file>
+ <file>
+ <title>The XSLT processor</title>
+ <description>Xalan is an XSLT processor that fully supports the W3C
specs.</description>
+ <used-by>Cocoon</used-by>
+ <lib>core/xalan-2.3.1.jar</lib>
+ <homepage>http://xml.apache.org/xalan/</homepage>
+ </file>
+ <file>
+ <title>The XML parser</title>
+ <description>Xerces is an XML parser.</description>
+ <used-by>Cocoon</used-by>
+ <lib>core/xercesImpl-2.0.0.jar</lib>
+ <homepage>http://xml.apache.org/xerces-j/</homepage>
+ </file>
+ <file>
+ <title>The XML APIs</title>
+ <description>JAXP, DOM and SAX interfaces.
+ These are the common interfaces for XML processing.</description>
+ <used-by>Cocoon</used-by>
+ <lib>core/xml-apis.jar</lib>
+ <homepage>http://xml.apache.org/commons/</homepage>
+ </file>
+ <file>
+ <title>Batik</title>
+ <description>Batik is a Java based toolkit for applications which handle
images in
+ the Scalable Vector Graphics (SVG) format for various purposes, such as
+ viewing, generation or manipulation.</description>
+ <used-by>cocoon</used-by>
+ <lib>optional/batik-all-1.5b1.jar</lib>
+ <homepage>http://xml.apache.org/batik/</homepage>
+ </file>
+ <file>
+ <title>BSF scripting framework</title>
+ <description>The Bean Scripting Framework (BSF) is an architecture for
+ incorporating scripting into, and enabling scripting against, Java
+ applications and applets. Using BSF, an application can use scripting,
+ and become scriptable, against any BSF-supported language. When BSF
+ supports additional languages, the application will automatically
+ support the additional languages.</description>
+ <used-by>?</used-by>
+ <lib>optional/bsf-2.2.jar</lib>
+ <homepage>http://oss.software.ibm.com/developerworks/projects/bsf</homepage>
+ </file>
+ <file>
+ <title>Common API for logging frameworks</title>
+ <description></description>
+ <used-by>Cocoon</used-by>
+ <lib>optional/commons-logging-1.0.jar</lib>
+ <homepage>?</homepage>
+ </file>
+ <file>
+ <title>Device capabilities</title>
+ <description>Open Source Delivery Context Java Library supporting CC/PP and
UAProf.
+ Different web-enabled devices have different input, output, hardware,
+ software, network and browser capabilities. In order for a web server or
+ web-based application to provide optimized content to different clients
+ it requires a description of the capabilities of the client known as the
+ delivery context.</description>
+ <used-by>DELI</used-by>
+ <lib>optional/deli-0.6.5.jar</lib>
+ <homepage>http://devnet.hp.com/projects/deli/</homepage>
+ </file>
+ <file>
+ <title>XML FO processor</title>
+ <description>FOP is a Java application that reads a formatting object tree
+ conforming to the XSL candidate release and then turns it into a PDF
+ document or allows you to preview it directly on screen.</description>
+ <used-by>FOP serializer</used-by>
+ <lib>optional/fop-0.20.3.jar</lib>
+ <homepage>http://xml.apache.org/fop/</homepage>
+ </file>
+ <file>
+ <title>Simple SQL database</title>
+ <description>hsqldb is a relational database engine written in Java, with a
JDBC
+ driver, supporting a subset of ANSI-92 SQL. It offers a small, fast
+ database engine which offers both in memory and disk based
tables.</description>
+ <used-by>?</used-by>
+ <lib>optional/hsqldb-1.61.jar</lib>
+ <homepage>http://hsqldb.sourceforge.net/</homepage>
+ </file>
+ <file>
+ <title>Create proprietary file formats</title>
+ <description>The POI project consists of APIs for manipulating
+ various file formats based upon Microsoft's OLE 2 Compound Document
+ format using pure Java.</description>
+ <used-by>?</used-by>
+ <lib>optional/jakarta-poi-1.6.0-dev-20020505.jar</lib>
+ <homepage>http://jakarta.apache.org/poi/</homepage>
+ </file>
+ <file>
+ <title>Jena RDF framework</title>
+ <description>Jena is a java API for manipulating RDF models.</description>
+ <used-by>DELI</used-by>
+ <lib>optional/jena-1.3.0.jar</lib>
+ <homepage>http://www.hpl.hp.com/semweb/jena-top.html</homepage>
+ </file>
+ <file>
+ <title>Image manipulation</title>
+ <description>Jimi is a class library for managing images. Its primary function
is
+ image I/O.</description>
+ <used-by>FOP</used-by>
+ <lib>optional/jimi-1.0.jar</lib>
+ <homepage>http://java.sun.com/products/jimi/</homepage>
+ </file>
+ <file>
+ <title>?</title>
+ <description></description>
+ <used-by>?</used-by>
+ <lib>optional/jisp_1_0_2.jar</lib>
+ <homepage>?</homepage>
+ </file>
+ <file>
+ <title>Java Formatter</title>
+ <description>This program formats Java code with consistent indentation and so
+ forth, to make it easier to read and maintain.</description>
+ <used-by>Cocoon</used-by>
+ <lib>optional/jstyle.jar</lib>
+ <homepage>http://www.redrival.com/greenrd/java/jstyle/</homepage>
+ </file>
+ <file>
+ <title>Transform HTML to XML</title>
+ <description>Tidy is a HTML syntax checker and pretty printer.</description>
+ <used-by>transformers</used-by>
+ <lib>optional/jtidy-04aug2000r7-dev.jar</lib>
+ <homepage>http://lempinen.net/sami/jtidy/</homepage>
+ </file>
+ <file>
+ <title>Search engine</title>
+ <description>jakarta-lucene is a search engine toolkit designed for
+ indexing and searching of documents.</description>
+ <used-by>?</used-by>
+ <lib>optional/lucene-1.2-rc2.jar</lib>
+ <homepage>http://jakarta.apache.org/lucene/</homepage>
+ </file>
+ <file>
+ <title>File Upload</title>
+ <description>MaybeUpload is a Java language package intended to make it much
easier
+ to write Servlets to handle RFC1867 file upload.</description>
+ <used-by>?</used-by>
+ <lib>optional/maybeupload_1-0-5pre3.jar</lib>
+ <homepage>http://www.weft.co.uk/library/maybeupload/</homepage>
+ </file>
+ <file>
+ <title>Java compiler</title>
+ <description>Java Compiler</description>
+ <used-by>XSP</used-by>
+ <lib>optional/pizza-1.1.jar</lib>
+ <homepage>http://pizzacompiler.sourceforge.net/</homepage>
+ </file>
+ <file>
+ <title>XML RDF parser</title>
+ <description></description>
+ <used-by>DELI</used-by>
+ <lib>optional/rdffilter.jar</lib>
+ <homepage>http://sourceforge.net/projects/rdf-filter</homepage>
+ </file>
+ <file>
+ <title>XML entity resolver</title>
+ <description></description>
+ <used-by>?</used-by>
+ <lib>optional/resolver-20020130.jar</lib>
+ <homepage>http://www.sun.com/xml/developers/resolver/</homepage>
+ </file>
+ <file>
+ <title>Servlet API</title>
+ <description></description>
+ <used-by>Cocoon</used-by>
+ <lib>optional/servlet_2_2.jar</lib>
+ <homepage>http://jakarta.apache.org/tomcat/</homepage>
+ </file>
+ <file>
+ <title>Velocity engine</title>
+ <description>Velocity is a general purpose template engine written in
Java.</description>
+ <used-by>?</used-by>
+ <lib>optional/velocity-1.2.jar</lib>
+ <homepage>http://jakarta.apache.org/velocity/</homepage>
+ </file>
+ <file>
+ <title>XML DB APIs</title>
+ <description>Database tailored for the storage of XML data.</description>
+ <used-by>?</used-by>
+ <lib>optional/xmldb-api-20011111.jar</lib>
+ <homepage>http://www.xmldb.org/</homepage>
+ </file>
+ <file>
+ <title>XT XSLT processor</title>
+ <description>XT is an implementation in Java of XSLT.</description>
+ <used-by>? (should be removed)</used-by>
+ <lib>optional/xt-19991105.jar</lib>
+ <homepage>http://www.jclark.com/xml/xt.html</homepage>
+ </file>
+ <file>
+ <title>Jakarta Commons JXPath</title>
+ <description>XPath interpreter.</description>
+ <used-by>JXPath logicsheet</used-by>
+ <lib>optional/commons-jpath-1.0b1.jar</lib>
+ <homepage>http://jakarta.apache.org/commons/jxpath/</homepage>
+ </file>
+ <file>
+ <title>Continuations-based JavaScript engine</title>
+ <description>Rhino is an implementation of JavaScript in Java.</description>
+ <used-by>Control flow</used-by>
+ <lib>optional/rhino1.5r4-continuations-20020429.jar</lib>
+ <homepage>http://www.mozilla.org/rhino/</homepage>
</file>
-
- <file description="Avalon Framework" used-by="Cocoon">
- core/avalon-framework-4.1.2.jar
- </file>
-
- <file description="Jakarta Commons Collections" used-by="Cocoon">
- core/commons-collections-1.0.jar
- </file>
-
- <file description="Jakart Commons httpClient" used-by="SOAP logicsheet">
- core/commons-httpclient-20020423.jar
- </file>
-
- <file description="Jakarta Regexp" used-by="sitemap matchers">
- core/jakarta-regexp-1.2.jar
- </file>
-
- <file description="Jakarta logkit" used-by="Cocoon logging">
- core/logkit-1.0.1.jar
- </file>
-
- <file description="The XSLT processor" used-by="Cocoon">
- core/xalan-2.3.1.jar
- </file>
-
- <file description="The XML parser" used-by="Cocoon">
- core/xercesImpl-2.0.0.jar
- </file>
-
- <file description="The XML APIs" used-by="Cocoon">core/xml-apis.jar</file>
-
- <file description="SVG" used-by="cocoon">optional/batik-all-1.5b1.jar</file>
-
- <file description="BSF scripting framework" used-by="?">
- optional/bsf-2.2.jar
- </file>
-
- <file description="Common API for logging frameworks" used-by="Cocoon">
- optional/commons-logging-1.0.jar
- </file>
-
- <file description="Device capabilities" used-by="DELI">
- optional/deli-0.6.5.jar
- </file>
-
- <file description="XML FO processor" used-by="FOP serializer">
- optional/fop-0.20.3.jar
- </file>
-
- <file description="Simple SQL database" used-by="?">
- optional/hsqldb-1.61.jar
- </file>
-
- <file description="Read proprietary file formats" used-by="?">
- optional/jakarta-poi-1.6.0-dev-20020505.jar
- </file>
-
- <file description="Jena RDF framework" used-by="DELI">
- optional/jena-1.3.0.jar
- </file>
-
- <file description="?" used-by="?">optional/jimi-1.0.jar</file>
-
- <file description="?" used-by="?">optional/jisp_1_0_2.jar</file>
-
- <file description="?" used-by="?">optional/jstyle.jar</file>
-
- <file description="Transform HTML to XML" used-by="transformers">
- optional/jtidy-04aug2000r7-dev.jar
- </file>
-
- <file description="Search engine" used-by="?">
- optional/lucene-1.2-rc2.jar
- </file>
-
- <file description="?" used-by="?">optional/maybeupload_1-0-5pre3.jar</file>
-
- <file description="Java compiler" used-by="XSP">optional/pizza-1.1.jar</file>
-
- <file description="XML RDF parser" used-by="DELI">
- optional/rdffilter.jar
- </file>
-
- <file description="XML entity resolver" used-by="?">
- optional/resolver-20020130.jar
- </file>
-
- <file description="Servlet API" used-by="Cocoon">
- optional/servlet_2_2.jar
- </file>
-
- <file description="Velocity engine" used-by="?">
- optional/velocity-1.2.jar
- </file>
-
- <file description="XML DB APIs" used-by="?">
- optional/xmldb-api-20011111.jar
- </file>
-
- <file description="XT XSLT processor" used-by="? (should be removed)">
- optional/xt-19991105.jar
- </file>
-
- <file description="Jakarta Commons JXPath" used-by="JXPath logicsheet">
- optional/commons-jpath-1.0b1.jar
- </file>
-
- <file description="Continuations-based JavaScript engine" used-by="Control flow">
- optional/rhino1.5r4-continuations-20020429.jar
- </file>
-
</jars>
1.7 +3 -307 xml-cocoon2/src/documentation/xdocs/installing/jars.xml
Index: jars.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/installing/jars.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- jars.xml 24 May 2002 14:02:07 -0000 1.6
+++ jars.xml 25 May 2002 15:32:00 -0000 1.7
@@ -8,313 +8,9 @@
</authors>
</header>
<body>
- <s1 title="What, why and when...">
- <p>This is a list of the available jars, what they are, where they come from,
- and what they do.</p>
- <note><strong>Required by Core Cocoon</strong> column is related to cocoon.jar
- itself, and not to the whole cocoon.war supplied with the release.
- If you want to build cocoon.war without any optional library (marked as
- <strong>No</strong>), make sure that components dependent on this library
- (see column <strong>Required by Cocoon Component</strong>) are not mentioned
- anywhere in <strong>cocoon.xconf</strong> and <strong>sitemap.xmap</strong>
- files.</note>
- <table>
- <tr>
- <th>Jar name</th>
- <th>Description</th>
- <th>Required by Core Cocoon</th>
- <th>Required by Cocoon Component</th>
- <th>Required by Cocoon Sample</th>
- <th>Comment</th>
- </tr>
- <tr>
- <td><link
href="http://jakarta.apache.org/avalon/excalibur/";>avalon-excalibur</link></td>
- <td>Part of jakarta-avalon, it is a set of classes and patterns that
- support high level server development.</td>
- <td>Yes</td>
- <td/>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link
href="http://jakarta.apache.org/avalon/framework/";>avalon-framework</link></td>
- <td>Part of jakarta-avalon, it is a set of classes and patterns that
- support high level server development.</td>
- <td>Yes</td>
- <td/>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link href="http://xml.apache.org/batik/";>batik-libs</link></td>
- <td>Batik is a Java based toolkit for applications which handle images in
- the Scalable Vector Graphics (SVG) format for various purposes, such as
- viewing, generation or manipulation.</td>
- <td>No</td>
- <td>SVGSerializer serializer ("svg2jpeg", "svg2png")</td>
- <td>Hello World - SVG, SVG Welcome page, etc</td>
- <td/>
- </tr>
- <tr>
- <td>
- <link
href="http://oss.software.ibm.com/developerworks/projects/bsf";>bsf</link>
- </td>
- <td>The Bean Scripting Framework (BSF) is an architecture for
- incorporating scripting into, and enabling scripting against, Java
- applications and applets. Using BSF, an application can use scripting,
- and become scriptable, against any BSF-supported language. When BSF
- supports additional languages, the application will automatically
- support the additional languages.</td>
- <td>No</td>
- <td>ScriptGenerator Generator ("script"), ScriptAction</td>
- <td>Dynamic Content - Javascript Generator and Python Generator</td>
- <td>I <em>believe</em> that this project is in talks with Apache to be
- 'adopted'.</td>
- </tr>
- <tr>
- <td>
- <link href="http://xml.apache.org/cocoon/";>Cocoon</link>
- </td>
- <td>Cocoon is a 100% pure Java publishing framework that relies on
- new W3C technologies (such as XML, XSL, SVG, etc..) to provide web
- content.</td>
- <td>Yes!</td>
- <td>All</td>
- <td>All</td>
- <td>Delete this == no webapp!</td>
- </tr>
- <tr>
- <td><link
href="http://jakarta.apache.org/commons/collections.html";>commons-collections</link></td>
- <td>Common implementations of collection classes.</td>
- <td>Yes</td>
- <td/>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link
href="http://jakarta.apache.org/commons/httpclient/";>commons-httpclient</link></td>
- <td>Although the java.net package provides basic support for accessing
- resources via HTTP, it doesn't provide the full flexibility or
- functionality needed by many applications. The Jakarta Commons HTTP Client
- component seeks to fill this void by providing an efficient, up-to-date,
- and feature-rich package implementing the client side of the most recent
- HTTP standards and recommendations.</td>
- <td>Yes</td>
- <td/>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link href="https://devnet.hp.com/projects/deli/";>deli</link></td>
- <td>Open Source Delivery Context Java Library supporting CC/PP and UAProf.
- Different web-enabled devices have different input, output, hardware,
- software, network and browser capabilities. In order for a web server or
- web-based application to provide optimized content to different clients
- it requires a description of the capabilities of the client known as the
- delivery context.</td>
- <td>No</td>
- <td/>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link href="http://xml.apache.org/fop/";>fop</link></td>
- <td>FOP is a Java application that reads a formatting object tree
- conforming to the XSL candidate release and then turns it into a PDF
- document or allows you to preview it directly on screen.</td>
- <td>No</td>
- <td>FOPSerializer serializer ("fo2pdf")</td>
- <td>Hello World - PDF, Static content - formatting objects</td>
- <td/>
- </tr>
- <tr>
- <td><link href="http://hsqldb.sourceforge.net/";>hsqldb</link></td>
- <td>hsqldb is a relational database engine written in Java, with a JDBC
- driver, supporting a subset of ANSI-92 SQL. It offers a small, fast
- database engine which offers both in memory and disk based tables.</td>
- <td>No</td>
- <td/>
- <td>Dynamic Content database demos, Sample Forms, Web Applications</td>
- <td>Used in the demos to provide a database.</td>
- </tr>
- <tr>
- <td><link href="http://www.hpl.hp.com/semweb/jena-top.html";>jena</link></td>
- <td> Jena is a java API for manipulating RDF models.</td>
- <td>No</td>
- <td>Deli</td>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link href="http://jakarta.apache.org/regexp/";>jakarta-regexp</link></td>
- <td>Regexp is a Java Regular Expression package that was graciously
- donated to the Apache Software Foundation by Jonathan Locke.</td>
- <td>Yes</td>
- <td>
- DirectoryGenerator ("directory") generator,
- RegexpURIMatcherFactory ("regexp") matcher,
- RegexpTargetHostMatcherFactory matcher,
- AbstractValidatorAction action,
- LocaleAction action
- </td>
- <td/>
- <td/>
- </tr>
- <tr>
- <td>javac</td>
- <td>Java Compiler.</td>
- <td>Yes</td>
- <td/>
- <td/>
- <td>Sitemap/xsp compilation. Can be replaced by another Java compiler,
- for example, <link
href="http://oss.software.ibm.com/developerworks/opensource/jikes/";>Jikes</link>.</td>
- </tr>
- <tr>
- <td><link href="http://java.sun.com/products/jimi/";>jimi</link></td>
- <td>Jimi is a class library for managing images. Its primary function is
- image I/O.</td>
- <td>No</td>
- <td/>
- <td/>
- <td>Used by FOP?</td>
- </tr>
- <tr>
- <td><link
href="http://www.redrival.com/greenrd/java/jstyle/";>jstyle</link></td>
- <td>This program formats Java code with consistent indentation and so
- forth, to make it easier to read and maintain.</td>
- <td>No</td>
- <td>JstyleFormatter java code formatter</td>
- <td/>
- <td>Sitemap and XSP code formatting, configured in cocoon.xconf</td>
- </tr>
- <tr>
- <td><link href="http://lempinen.net/sami/jtidy/";>jtidy</link></td>
- <td>Tidy is a HTML syntax checker and pretty printer.</td>
- <td>No</td>
- <td>HTMLGenerator generator ("html")</td>
- <td>News Feeds examples</td>
- <td/>
- </tr>
- <tr>
- <td><link href="http://jakarta.apache.org/avalon/logkit/";>logkit</link></td>
- <td>jakarta-avalon-logkit is a logging toolkit designed for secure
- performance orientated logging in applications.</td>
- <td>Yes</td>
- <td/>
- <td/>
- <td>Cocoon logging.</td>
- </tr>
- <tr>
- <td><link href="http://jakarta.apache.org/lucene/";>lucene</link></td>
- <td>jakarta-lucene is a search engine toolkit designed for
- indexing and searching of documents.</td>
- <td>No</td>
- <td>SearchGenerator Generator, Search components</td>
- <td>Search</td>
- <td>Cocoon XML search.</td>
- </tr>
- <tr>
- <td><link
href="http://www.weft.co.uk/library/maybeupload/";>maybeupload</link></td>
- <td>MaybeUpload is a Java language package intended to make it much easier
- to write Servlets to handle RFC1867 file upload.</td>
- <td>No</td>
- <td/>
- <td/>
- <td>File upload capability - very useful in servlet environment.</td>
- </tr>
- <tr>
- <td><link href="http://pizzacompiler.sourceforge.net/";>pizza</link></td>
- <td>Java Compiler</td>
- <td>No</td>
- <td/>
- <td/>
- <td>Sitemap/xsp compilation. Replacement for the Sun's javac compiler.</td>
- </tr>
- <tr>
- <td><link
href="http://sourceforge.net/projects/rdf-filter";>rdffilter</link></td>
- <td>?</td>
- <td>No</td>
- <td>Deli</td>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link
href="http://www.sun.com/xml/developers/resolver/";>resolver</link></td>
- <td>Entity resolution catalogs - XML Entity and URI Resolvers</td>
- <td>Yes</td>
- <td>Resolver</td>
- <td>Entity Catalogs</td>
- <td/>
- </tr>
- <tr>
- <td><link href="http://www.mozilla.org/rhino/";>rhino</link></td>
- <td>Rhino is an implementation of JavaScript in Java.</td>
- <td>No</td>
- <td>ScriptGenerator generator ("script")</td>
- <td>Dynamic Content - Javascript Generator</td>
- <td/>
- </tr>
- <tr>
- <td><link href="http://jakarta.apache.org/tomcat/";>servlet</link></td>
- <td>Java Servlet API</td>
- <td>No</td>
- <td/>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link href="http://jakarta.apache.org/velocity/";>velocity</link></td>
- <td>Velocity is a general purpose template engine written in Java.</td>
- <td>No</td>
- <td>VelocityGenerator generator ("velocity")</td>
- <td>Dynamic Content - Velocity Generator</td>
- <td>Does this jar <strong>need</strong> to include within it other
- projects, eg oro and logkit?</td>
- </tr>
- <tr>
- <td><link href="http://www.xmldb.org/";>xmldb</link></td>
- <td>Database tailored for the storage of XML data.</td>
- <td>No</td>
- <td/>
- <td/>
- <td/>
- </tr>
- <tr>
- <td><link href="http://xml.apache.org/xalan/";>xalan</link></td>
- <td>Xalan is an XSLT processor that fully supports the W3C specs.</td>
- <td>Yes</td>
- <td/>
- <td/>
- <td>XSL transformations - can be replaced by another XSLT processor.</td>
- </tr>
- <tr>
- <td><link href="http://xml.apache.org/xerces-j/";>xerces</link></td>
- <td>Xerces is an XML parser.</td>
- <td>Yes</td>
- <td/>
- <td/>
- <td>XML parsing - can be replaced by another XML parser.</td>
- </tr>
- <tr>
- <td><link href="http://xml.apache.org/commons/";>xml-apis</link></td>
- <td>JAXP, DOM and SAX interfaces.
- These are the common interfaces for XML processing.
- </td>
- <td>Yes</td>
- <td>All</td>
- <td>All</td>
- <td/>
- </tr>
- <tr>
- <td><link href="http://www.jclark.com/xml/xt.html";>xt</link></td>
- <td>XT is an implementation in Java of XSLT.</td>
- <td>No</td>
- <td>XTTransformer transformer</td>
- <td/>
- <td>? why have xt <strong>and</strong> xalan. Has this not been
- superseded by the TraxTransformer ?</td>
- </tr>
- </table>
+ <s1 title="Replace">
+ <p>This is now an autogenerated file. If you see this message, somethings
+ wrong with the build!.</p>
</s1>
</body>
</document>
1.3 +91 -32 xml-cocoon2/tools/src/check-jars.xsl
Index: check-jars.xsl
===================================================================
RCS file: /home/cvs/xml-cocoon2/tools/src/check-jars.xsl,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- check-jars.xsl 24 May 2002 09:30:45 -0000 1.2
+++ check-jars.xsl 25 May 2002 15:32:00 -0000 1.3
@@ -25,6 +25,21 @@
<xsl:template match="/">
<xsl:variable name="declared" select="jars/*"/>
+ <!-- Validate lib/jars.xml prior to checking files -->
+
+ <!-- Verify that all the entries in lib/jars.xml have appropriate tags -->
+ <xsl:apply-templates select="//file" mode="no-tag"/>
+
+ <!-- Verify that all the file entries are unique -->
+ <xsl:for-each select="$jars.xml/jars/file">
+ <xsl:variable name="this" select="normalize-space(lib/text())"/>
+ <xsl:if test="count($jars.xml/jars/file[normalize-space(lib/text()) = $this])
> 1">
+ <xsl:message terminate="yes">
+ Duplicate entry for file <xsl:value-of select="$this"/>.
+ </xsl:message>
+ </xsl:if>
+ </xsl:for-each>
+
<!-- Verify if files declared in jars.xml appear in the lib/ directory -->
<xsl:for-each select="$declared">
<xsl:apply-templates select="." mode="declared-but-doesnt-appear"/>
@@ -35,29 +50,40 @@
<xsl:apply-templates select="." mode="appears-but-not-declared"/>
</xsl:for-each>
- <!-- Verify that all the entries in lib/jars.xml have a description
- attribute
- -->
- <xsl:apply-templates select="//file" mode="no-description-attribute"/>
-
- <!-- Verify that all the file entries are unique -->
- <xsl:for-each select="$jars.xml/jars/file">
- <xsl:variable name="this" select="normalize-space(text())"/>
- <xsl:if test="count($jars.xml/jars/file[normalize-space(text()) = $this]) >
1">
- <xsl:message terminate="yes">
- Duplicate entry for file <xsl:value-of select="$this"/>.
- </xsl:message>
- </xsl:if>
- </xsl:for-each>
+ <!-- create the documentation -->
+ <!-- FIXME: how can I get the doctype into the output? -->
+ <!-- DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.0//EN"
"../dtd/document-v10.dtd" -->
+ <document>
+ <header>
+ <title>Cocoon JARs</title>
+ <authors>
+ <person name="John Morrison" email="[EMAIL PROTECTED]"/>
+ </authors>
+ </header>
+ <body>
+ <s1 title="What, why and when...">
+ <p>This is a list of the available jars, what they are, where they come from,
+ and what they do.</p>
+ <table>
+ <tr>
+ <th>Title</th>
+ <th>Jar (type/name)</th>
+ <th>Description</th>
+ <th>Used by</th>
+ </tr>
+ <xsl:apply-templates select="//file" mode="documentation"/>
+ </table>
+ </s1>
+ </body>
+ </document>
</xsl:template>
-
<!-- Template to verify if files declared in jars.xml appear in the
lib/ directory
- -->
- <xsl:template match="node()" mode="declared-but-doesnt-appear">
- <xsl:variable name="this" select="normalize-space(text())"/>
- <xsl:if test="count($directory/jars/jar[normalize-space(text()) = $this]) = 0">
+ -->
+ <xsl:template match="file/lib" mode="declared-but-doesnt-appear">
+ <xsl:variable name="this" select="normalize-space(lib/text())"/>
+ <xsl:if test="count($directory/jars/jar[normalize-space(lib/text()) = $this]) =
0">
<xsl:message terminate="yes">
File <xsl:value-of select="$this"/> is declared in lib/jars.xml, but doesn't
appear in the lib/ directory.
@@ -65,13 +91,12 @@
</xsl:if>
</xsl:template>
-
<!-- Template to verify that files that appear in lib/ are declared
in jars.xml
- -->
- <xsl:template match="node()" mode="appears-but-not-declared">
- <xsl:variable name="this" select="normalize-space(text())"/>
- <xsl:if test="count($jars.xml/jars/file[normalize-space(text()) = $this]) = 0">
+ -->
+ <xsl:template match="file/lib" mode="appears-but-not-declared">
+ <xsl:variable name="this" select="normalize-space(lib/text())"/>
+ <xsl:if test="count($jars.xml/jars/file[normalize-space(lib/text()) = $this]) =
0">
<xsl:choose>
<xsl:when test="starts-with($this, 'local/')">
<xsl:message>
@@ -88,21 +113,55 @@
</xsl:if>
</xsl:template>
- <!-- Verify if a file element has a "description" attribute -->
- <xsl:template match="file[not(@description)]" mode="no-description-attribute">
+ <!-- Verify if a file element has a "title" tag -->
+ <xsl:template match="file[not(title)]" mode="no-tag">
+ <xsl:message terminate="yes">
+ Entry for file <xsl:value-of select="normalize-space(lib/text())"/> in the
lib/jars.xml does not have a "title" tag.
+
+ Please add a title tag before continuing.</xsl:message>
+ </xsl:template>
+
+ <!-- Verify if a file element has a "description" tag -->
+ <xsl:template match="file[not(description)]" mode="no-tag">
<xsl:message terminate="yes">
- Entry for file <xsl:value-of select="normalize-space(text())"/> in the
lib/jars.xml does not have a "description" attribute.
+ Entry for file <xsl:value-of select="normalize-space(lib/text())"/> in the
lib/jars.xml does not have a "description" tag.
- Please add a description attribute before continuing.</xsl:message>
+ Please add a description tag before continuing.</xsl:message>
</xsl:template>
+ <!-- Verify if a file element has an "used-by" tag -->
+ <xsl:template match="file[not(used-by)]" mode="no-tag">
+ <xsl:message terminate="yes">
+ Entry for file <xsl:value-of select="normalize-space(lib/text())"/> in the
lib/jars.xml does not have a "used-by" tag.
+
+ Please add an "used-by" tag before continuing.</xsl:message>
+ </xsl:template>
- <!-- Verify if a file element has an "used-by" attribute -->
- <xsl:template match="file[not(@used-by)]" mode="no-description-attribute">
+ <!-- Verify if a file element has an "url" tag -->
+ <xsl:template match="file[not(homepage)]" mode="no-tag">
<xsl:message terminate="yes">
- Entry for file <xsl:value-of select="normalize-space(text())"/> in the
lib/jars.xml does not have a "used-by" attribute.
+ Entry for file <xsl:value-of select="normalize-space(lib/text())"/> in the
lib/jars.xml does not have a "homepage" tag.
+
+ Please add an "homepage" tag before continuing.</xsl:message>
+ </xsl:template>
+
+ <!-- Dont output anything if entry has all the required tags -->
+ <xsl:template match="*" mode="no-tag" priority="-1"/>
+
+ <!-- Dont output anything if declared entries appear -->
+ <xsl:template match="*" mode="declared-but-doesnt-appear" priority="-1"/>
+
+ <!-- Dont output anything if jar files are declared -->
+ <xsl:template match="*" mode="appears-but-not-declared" priority="-1"/>
- Please add an "used-by" attribute before continuing.</xsl:message>
+ <!-- Format for documentation -->
+ <xsl:template match="file" mode="documentation">
+ <tr>
+ <td><link href="{homepage}"><xsl:value-of select="title"/></link></td>
+ <td><xsl:value-of select="lib"/></td>
+ <td><xsl:value-of select="description"/></td>
+ <td><xsl:value-of select="used-by"/></td>
+ </tr>
</xsl:template>
</xsl:stylesheet>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
