The requirement for Java 5 in JavaDoc generation was because I wrote two taglets

http://svn.geotools.org/geotools/trunk/gt/build/maven/javadoc/src/main/java/org/geotools/maven/taglet/

and unfortunatly the taglet API was not stabilized before Java 5, so those
taglets will not work when generating the Javadoc with Java 4.

The most useful taglet is @source, which give us the module where belong a
class. Example:

http://javadoc.geotools.fr/snapshot/org/geotools/referencing/CRS.html

look at the last line just before the "Method summary" section. It is written:

Module:
   modules/library/referencing  (gt2-referencing.jar) (Maven report) (SVN head)

The same should apply to every class in the whole GeoTools API. This information
has not been added because of a weid idea of mine - users really asked for that
on the mailing list. They want to know in which JAR is a class. This information
will not be part of the javadoc if you create it with Java 4.

        Martin

-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Geotools-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/geotools-devel

Reply via email to