User: rinkrank
Date: 02/07/09 18:07:03
Modified: modules modules-common.xml
Log:
Improved tag docs. They now say at what level (class, method, field, constructor) a
tag belongs. This involves a change in xtags.dtd. There is a new <level> tag which
more or less replaces the corresponding conditions for class and method. Also added
"cardinality" - whether a tag can occur more than once. In order to do this I had to
trade the old XSLT transfromation for Anakia, which is more powerful (at least it
makes me more powerful ;-)
Revision Changes Path
1.8 +33 -33 xdoclet/modules/modules-common.xml
Index: modules-common.xml
===================================================================
RCS file: /cvsroot/xdoclet/xdoclet/modules/modules-common.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -w -r1.7 -r1.8
--- modules-common.xml 12 Jun 2002 23:31:34 -0000 1.7
+++ modules-common.xml 10 Jul 2002 01:07:02 -0000 1.8
@@ -205,10 +205,10 @@
</target>
<!-- =================================================================== -->
- <!-- Generate tag docs using XSLT -->
+ <!-- Generate tag docs using XSLT (obsolete, Anakia is used instead) -->
<!-- =================================================================== -->
- <target
- name="docs"
+ <!--target
+ name="docs-old"
depends="init"
description="Generate tag docs using XSLT"
if="module.xtags.exists"
@@ -233,49 +233,49 @@
<copy file="${docs.resources.dir}/tags.css" todir="${docs.tags.dir}"/>
<copy file="${docs.resources.dir}/tablesort.js" todir="${docs.tags.dir}"/>
- </target>
+ </target-->
<!-- =================================================================== -->
- <!-- Generate tag docs using Anakia (TODO) This will include an extra -->
- <!-- column indicating the level for a tag. (class/method/field/constr. -->
+ <!-- Generate tag docs using Anakia. -->
<!-- =================================================================== -->
<target
- name="adocs"
+ name="docs"
depends="init"
description="Generate tag docs using Anakia"
if="module.xtags.exists"
+ unless="module.tag.docs.uptodate"
>
+ <mkdir dir="${docs.tags.dir}"/>
+ <path id="doc.class.path">
+ <fileset dir="${lib.dir}">
+ <include name="**/*.jar" />
+ </fileset>
+ <fileset dir="${dist.lib.dir}">
+ <include name="**/*.jar" />
+ </fileset>
+ </path>
<taskdef
name="anakia"
classname="org.apache.velocity.anakia.AnakiaTask"
-
classpath="${lib.dir}/velocity.jar;${lib.dir}/jdom.jar;${lib.dir}/commons-collections.jar;${lib.dir}/log4j.jar"
+ classpathref="doc.class.path"
/>
- <mkdir dir="${docs.tags.dir}"/>
<anakia
basedir="${module.src.dir}/META-INF"
destdir="${docs.tags.dir}"
- extension="-anakia.html"
+ extension="-anakia-tmp.html"
+ projectFile="resources/project.xml"
includes="xtags.xml"
lastModifiedCheck="true"
- templatePath="F:\xdoclet\xdoclet\docs\modules"
- style="site.vsl"
- projectFile="project.xml"
+ templatePath="${docs.stylesheets.dir}"
+ style="./xtags2html.vsl"
+ >
+ </anakia>
+ <move
+ file="${docs.tags.dir}/xtags-anakia-tmp.html"
+ tofile="${docs.tags.dir}/${ant.project.name}-tags.html"
/>
-
- <!--copy todir="${docs.dest}/images" filtering="no">
- <fileset dir="${docs.src}/images">
- <include name="**/*.gif"/>
- <include name="**/*.jpeg"/>
- <include name="**/*.jpg"/>
- </fileset>
- </copy-->
- <!-- In case we have CSS someday
- <copy todir="${docs.dest}" filtering="no">
- <fileset dir="${docs.src}">
- <include name="**/*.css"/>
- </fileset>
- </copy>
- -->
+ <copy file="${docs.resources.dir}/tags.css" todir="${docs.tags.dir}"/>
+ <copy file="${docs.resources.dir}/tablesort.js" todir="${docs.tags.dir}"/>
</target>
<!-- =================================================================== -->
-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Stuff, things, and much much more.
http://thinkgeek.com/sf
_______________________________________________
Xdoclet-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/xdoclet-devel
