File APIs for Java Developers
Manipulate DOC, XLS, PPT, PDF and many others from your application.
http://aspose.com/file-tools
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes Explain Javadoc Usuage! Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login


Win a copy of Spring in Action this week in the Spring forum!
JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "Explain Javadoc Usuage!" Watch "Explain Javadoc Usuage!" New topic
Author

Explain Javadoc Usuage!

Vikas Sood
Ranch Hand

Joined: Sep 03, 2002
Posts: 109
Hi friends,
As required by the specs i am using javadoc to create documentaion comments.
I am using the following command line:
javadoc -private suncertify.db suncertify.client suncertify.server
Everything runs fine and javadoc files are created without any error of any type.But the problem lyes in the fact that apart from including all private comments, the use of -private option causes generation of javadoc files for all inner classes as well.As i have not documented these classes, they come out rather plain.the question is should i document them as well as i am already documenting all the private members, or can you suggest a way of them not getting created.
Kindly comment

VikasSood
S. Ganapathy
Ranch Hand

Joined: Mar 26, 2003
Posts: 194
Hi Vikas,
Why are you using private option to generate javadoc? Is it must to generate documentation for all scopes (public, protected, package, private)?
I am thinking to provide documentation only on all public mentods, and protected methods if any but not on private, and package visibility. Even Java API provides only public and protected scopes only.
Regards,
Ganapathy.
Vikas Sood
Ranch Hand

Joined: Sep 03, 2002
Posts: 109
Hi Ganapathy,
I have gone through this forum regarding the use of private option for generating javadoc documentation, and found many people doing it, including Mark,and also it helps a user of documentation get more information regarding the application by having access to documentation of all the members of the application.Irrespective of those members being private ,protected or public.
Do you know of some way to prevent documentation of inner classes?
VikasSood
Andrew Monkhouse
author and jackaroo
Marshal Commander

Joined: Mar 28, 2003
Posts: 11476
    
  94

Hi Vikas
I documented all my private classes and variables as though they were to be documented using Javadoc, but for the submission I only used the standard javadoc (I did not specify the "-private").
I got 100% for documentation, so I believe that it is not necessary for you to use "-private".
Regards, Andrew


The Sun Certified Java Developer Exam with J2SE 5: paper version from Amazon, PDF from Apress, Online reference: Books 24x7 Personal blog
Vikas Sood
Ranch Hand

Joined: Sep 03, 2002
Posts: 109
Hi Andrew,
So that means I will have to document all the inner classes and annonymous classes i have used, and would be ok if i run javadoc without the -private option.
kindly comment
VikasSood
Andrew Monkhouse
author and jackaroo
Marshal Commander

Joined: Mar 28, 2003
Posts: 11476
    
  94

Hi Vikas,
I did not have any inner classes in my app, and for annonymous clases I just used C++ style comments (I ignored what it could do to javadoc):

Regards, Andrew
[ June 09, 2003: Message edited by: Andrew Monkhouse ]
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: Explain Javadoc Usuage!