Dealing with Javadoc Comments in Eclipse
When you use Eclipse to write Java code, don’t forget to edit the Javadoc comments (the things that start with /**). You can add useful information when you edit the Javadoc comments, and as you edit them, Eclipse’s code assist offers suggestions. Remember these tips as you edit your Javadoc comments:
Add a Javadoc comment: Place the cursor in the editor at the point where the new Javadoc comment belongs. Then choose Source→Add Javadoc Comment from the main menu bar.
Create Javadoc pages from existing Javadoc comments: Select the projects or source files whose Javadoc pages you want to create. (Select them in the Package Explorer, the Navigator view, the Outline view, or in an editor.) Then, on the main menu bar, choose Project→Generate Javadoc.
See an existing Javadoc page: Select the element whose Javadoc page you want to see. (Select it in the Package Explorer, the Outline view, or in an editor.) Then, on the main menu bar, choose Navigate→Open External Javadoc.