[Sandboss-devel] Doclets

[Steve M. <sm...@ma...>]

I'm setting up the doclet infrastructure, and have run into a couple of 
annoyances. The big one is that everything in doclet-land works off 
static methods. I'm sure there was a reason that was done, but it's a 
pain in the butt to work with. I'm trying to find a way around that, and 
I've come up with a couple of solutions.

1) Create a master doclet that instantiates other doclets. The doclets 
instantiated by the master doclet would look just like any other doclet, 
but they wouldn't have static methods .

2) Create a master doclet that instantiates other classes. The other 
classes could be nothing more than glorified PrintWriters that would 
output stuff the same way a doclet normally would. This is the solution 
that the Standard Doclet uses; see 
<http://java.sun.com/j2se/1.3/docs/tooldocs/javadoc/source/>.

3) doclet.start()  could instantiate a subdoclet (or an instance of 
itself, whatever) that would then be free from restrictions imposed by 
static methods.


I'm not sure which solution I like the best....they''re all about the 
same, it seems. #3 is just  bit less work than the others. Any thoughts?

Steve