You are viewing a plain text version of this content. The canonical link for it is here.
Posted to alexandria-dev@jakarta.apache.org by ru...@apache.org on 2002/01/08 19:10:17 UTC
cvs commit: jakarta-alexandria/proposal/gump/stylesheet pubdocs.xsl
rubys 02/01/08 10:10:17
Modified: proposal/gump build.xml
proposal/gump/site/xdocs project.xml workspace.xml
Added: proposal/gump/stylesheet pubdocs.xsl
Log:
Complete the integration and documentation of the process by which
documents are published.
Revision Changes Path
1.5 +7 -1 jakarta-alexandria/proposal/gump/build.xml
Index: build.xml
===================================================================
RCS file: /home/cvs/jakarta-alexandria/proposal/gump/build.xml,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- build.xml 7 Jan 2002 21:46:19 -0000 1.4
+++ build.xml 8 Jan 2002 18:10:17 -0000 1.5
@@ -87,13 +87,19 @@
classpath="jenny.jar"/>
</target>
+ <!-- Generate publish instructions for the javadocs -->
+ <target name="pubdocs" depends="gen">
+ <style in="work/merge.xml" out="work/pubdoc.pl"
+ style="stylesheet/pubdocs.xsl"/>
+ </target>
+
<!-- Produce the gump web site -->
<target name="site">
<ant dir="site"/>
</target>
<!-- Do everything -->
- <target name="all" depends="scripts,javadocs,site"/>
+ <target name="all" depends="scripts,javadocs,pubdocs,site"/>
<!-- Remove all outputs and intermediate results -->
<target name="clean">
1.7 +21 -0 jakarta-alexandria/proposal/gump/site/xdocs/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-alexandria/proposal/gump/site/xdocs/project.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- project.xml 1 Jan 2002 18:25:37 -0000 1.6
+++ project.xml 8 Jan 2002 18:10:17 -0000 1.7
@@ -272,6 +272,27 @@
</table>
</subsection>
+ <subsection name="javadoc">
+ <p>This declares where the outputs of the
+ <a href="http://java.sun.com/j2se/javadoc/index.html">javadoc</a> tool
+ outputs are placed. This option only has any meaning if the
+ <a href="workspace.html#javadoc"><javadoc></a> element is present
+ in the workspace definition.</p>
+
+ <table>
+ <tr>
+ <th>Attribute</th>
+ <th>Description</th>
+ <th>Required?</th>
+ </tr>
+ <tr>
+ <td>nested</td>
+ <td>Name of a directory or file, relative to the srcdir of the module
+ containing this project.</td>
+ <td>No</td>
+ </tr>
+ </table>
+ </subsection>
</section>
</body>
</document>
1.8 +4 -3 jakarta-alexandria/proposal/gump/site/xdocs/workspace.xml
Index: workspace.xml
===================================================================
RCS file: /home/cvs/jakarta-alexandria/proposal/gump/site/xdocs/workspace.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- workspace.xml 31 Oct 2001 14:18:45 -0000 1.7
+++ workspace.xml 8 Jan 2002 18:10:17 -0000 1.8
@@ -237,9 +237,10 @@
<tr>
<td>dir</td>
<td>This attribute tells where the physical directory associated with
- the url can be found. <b>Note:</b> the code which copies the
- javadocs to this directory is currently not integrated into Gump.
- This will be corrected shortly.</td>
+ the url can be found. <b>Note:</b> the script which copies the
+ javadocs to this directory is named pubdoc.pl and is placed in the
+ work subdirectory of gump. Normally, it would be executed
+ immediately after a "build all"</td>
<td>No</td>
</tr>
</table>
1.1 jakarta-alexandria/proposal/gump/stylesheet/pubdocs.xsl
Index: pubdocs.xsl
===================================================================
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:output method="text" omit-xml-declaration="yes"/>
<xsl:template match="workspace">
<script>#!/usr/bin/perl
use File::Copy;
use File::Path;
my %map = (<xsl:apply-templates select="*"/>);
foreach $source (keys %map) {
if (-d $source) {
$dest = $map{$source};
rmtree $dest, 0, 0;
mkpath $dest, 0, 0775;
system "cp -r $source $dest";
}
}
</script>
</xsl:template>
<xsl:template match="javadoc/description[@dest]">
<data>
"<xsl:value-of select="@source"/>" =>
"<xsl:value-of select="@dest"/>",</data>
</xsl:template>
<xsl:template match="*">
<xsl:apply-templates select="*"/>
</xsl:template>
</xsl:stylesheet>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>