#1 tool should not be JSP pages

[Jeff Wright]

In my opinion, the JspDoc tool should not be delivered
as a collection of JSP pages. This requires tool
files (e.g., directoryjsp2.jsp) to be in the project
directory with my web application files. I recommend
making this tool a command line utility, as in javadoc.

And supplying an ant Task to run this would be very
nice.

As far as formatting, I suggest either using a
template system such as Apache Velocity or building
the docs as XML and using an XSL stylesheet to create
HTML.