Name: dk30142 Date: 11/20/2002

Users occasionally ask for a way to print lists of information derived
from their custom tags. It would be useful to provide, perhaps as
part of the @todo tag (that we might eventually add as a standard tag)
a taglet ability for it to print out to a separate file. They could then
copy this taglet and simply change the tag name to work with their
custom tag.

Here is such a request:
  Will JavaDoc be able to handle modification histories for a program?
  Such tags as @modification or @feature-added or something simliar
  so that you would be able to print out a list of program alterations
  between either a time period or a version/release/build combination?

Our reply to him was:
  The simplest approach, if you write Java code,
  is to modify this custom doclet to print out the tags you want:

  http://java.sun.com/j2se/1.4.1/docs/tooldocs/javadoc/overview.html#customtags

  The root.classes() method contains all classes in the current Javadoc run
  including nested classes.

  This code loops over only the methods to print out the text for the tags
  named "mytag" (as in @mytag). You could extend it to also loop over
  fields and constructors.
 
======================================================================