Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Javadoc template generator [closed]

I have a large codebase without Javadoc, and I want to run a program to write a skeleton with the basic Javadoc information (e.g., for each method's parameter write @param...), so I just have to fill the gaps left.

Anyone know a good solution for this?

Edit:

JAutodoc is what I was looking for. It has Ant tasks, an Eclipse plugin, and uses Velocity for the template definition.

like image 208
Alotor Avatar asked Aug 27 '08 07:08

Alotor


People also ask

How do I find my generated Javadoc?

From the main menu, select Tools | Generate JavaDoc. In the dialog that opens, select a scope — a set of files or directories for which you want to generate the reference, and set the output directory where the generated documentation will be placed.

Is Javadoc still used?

Javadoc is pretty much the accepted standard for documenting java code.

How do I create an automatic Javadoc?

In the Package Explorer view, select a Java project and click Project > Generate Javadoc with Diagrams > Automatically. In the Generate Javadoc wizard, under Javadoc command, select the Javadoc command (an executable file).


1 Answers

The JAutodoc plugin for eclipse does exactly what you need, but with a package granularity :

right click on a package, select "Add javadoc for members..." and the skeleton will be added.

There are numerous interesting options : templates for javadoc, adding a TODO in the header of every file saying : "template javadoc, must be filled...", etc.

like image 98
Laurent K Avatar answered Sep 22 '22 19:09

Laurent K