DocFlex/Javadoc - Tutorials
Tutorial 1: Creating a very simple template
This tutorial shows how to create a template which generates a very simple
doc -- just the listing of classes specified on the Javadoc command line to document.
- Classes directly specified on the Javadoc command line
- Classes contaned in the packages specified on the command line
- Classes contained in other classes (inner classes)
Tutotial 2: Grouping methods by tags
We have received from our customer the following email:
Here is how that task can be solved with a template:
I'd like to use tags to group methods.
For example we'd like to produce the standard javadoc documentation where
there is also a link to an additional page. This additional page should
contain methods which are grouped together by own tags.
My own tags are like the following:
I have classes in different packages and the methods in the classes can have
Method1 in packageOne.classA has the tag @ADMIN
Method2 in packageOne.classA has the tag @USER
Method1 in packageTwo.classA has the tag @USER
Method2 in packageTwo.classB has the tag @ADMIN
The javadoc documentation should then contain something like:
The zip archive includes both the Flash/HTML viewlet and
'methods_by_tags.tpl' template (explained in it).
Although, at the moment, we cannot prepare the full tutorial course,
it's very much possible to highlight some specific topics interesting to the users.
Please, do not hesitate to send us your questions to:
You can also look at
DocFlex/XML | Tutorials.
This is not about Javadoc. However, all basic ideas are the same!