aspose file tools*
The moose likes Developer Certification (SCJD/OCMJD) and the fly likes Aaak! Javadoc comments! Big Moose Saloon
  Search | Java FAQ | Recent Topics | Flagged Topics | Hot Topics | Zero Replies
Register / Login
JavaRanch » Java Forums » Certification » Developer Certification (SCJD/OCMJD)
Bookmark "Aaak! Javadoc comments!" Watch "Aaak! Javadoc comments!" New topic
Author

Aaak! Javadoc comments!

Robert Konigsberg
Ranch Hand

Joined: Jun 23, 2004
Posts: 172
Hi,

Looks like javadoc likes adding implied constructors to the documentation. Does this mean I need to supply default constructors, just so I can add javadoc comments?!

Did people pass the exam without these?

Thanks, Rob


SCJP 1.4 (91%)<br />SCJD 1.4 (376/400, 94%)
Javini Javono
Ranch Hand

Joined: Dec 03, 2003
Posts: 286
Hi,

I'm not a JavaDoc specialist, but if what you assert is true,
then I'd say that you would want to declare the default
constructor and based upon docCheck, you can have a
simple one-liner to document it.

Another factor that comes into play is how much JavaDoc
you are doing. I'm using the -public flag. If you are using
JavaDoc at the package private level, then perhaps this is why
you are getting JavaDoc non-comments for constructors to
classes which are not public.

All in all, I attempt to not have anything show up in the JavaDoc
which is not documented by me. And, using the -public flag
may not be the norm, but it is what I decided to use.

Thanks,
Javini Javono
[ July 02, 2004: Message edited by: Javini Javono ]
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: Aaak! Javadoc comments!
 
Similar Threads
URLyBird interface javadoc?
write to a file without delete it (noob question)
Question about comments
Document Accessors ? A matter of Style
style guide