
 = Some Javadoc Research

 INTRO

   javadoc is the tool which extracts documentation from java code source files and
   transforms this into html. This file is about some research of the best ways
   to use javadoc. It would be pleasant to be able to transform javadoc documentation
   comments into formats other than HTML such as docbook xml. It is possible that by
   using a different 'doclet' this may be possible.


 SOME RESEARCH

   http://java.sun.com/j2se/javadoc/
     The javadoc tool home-page on the Sun Micro-systems site.

   http://java.sun.com/j2se/1.4.1/docs/tooldocs/windows/javadoc.html#javadoctags
     This is the page and section which contains a reference list of what 'tags'
     (ie @tagname) are allowable in javadoc comments. Custom tags are also possible
     with the 'taglet' api. This page is oriented towards Microsoft Windows.
