aspose file tools*
The moose likes Beginning Java and the fly likes What is a 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 » Java » Beginning Java
Bookmark "What is a "javadoc utility" and good documentation?" Watch "What is a "javadoc utility" and good documentation?" New topic
Author

What is a "javadoc utility" and good documentation?

Ansmeon Kamen
Greenhorn

Joined: Jan 08, 2013
Posts: 3
if your told to "include documentation readable by the javadoc utility suitable to the program's size" what is a "javadoc utility?.Would it be like Eclipse or whatever is "containing" Java?.Also could anyone give me an example of a Java program with excellent documentation please?.
Jesper de Jong
Java Cowboy
Saloon Keeper

Joined: Aug 16, 2005
Posts: 14270
    
  21

Javadoc is a tool that comes with the JDK, which you can use to generate documentation which looks like the standard Java API documentation.

It works like this: you put specially formatted comments above your classes, methods, interfaces etc., then run the Javadoc tool on your source code, and it then produces a directory containing HTML files.

See the documentation about Javadoc.

Javadoc comments start with /** and end with */. Here's a simple example:


Java Beginners FAQ - JavaRanch SCJP FAQ - The Java Tutorial - Java SE 8 API documentation
Campbell Ritchie
Sheriff

Joined: Oct 13, 2005
Posts: 39422
    
  28
Also, you might find this thread helpful.
Jj Taylor
Greenhorn

Joined: Jan 20, 2013
Posts: 19
It's a really cool to use I've just started to understand it better, its definatly worth reading more about creating classes & methods yourself first so its easier to understand the classes that come with the SDK and you can be well away creating GUI's - if you wanted

My advice from starting out is Javas own tutorial was tricky to understand at first but I didnt know where to look compared to your step-by-step over advertised tutorial websites

After I found the right place on Javas own site things started becoming more clearer and in depth

http://docs.oracle.com/javase/tutorial/java/index.html
Campbell Ritchie
Sheriff

Joined: Oct 13, 2005
Posts: 39422
    
  28
The Java tutorial has a few things in I don’t agree with, but it is by far the most comprehensive teaching resource I have ever seen for Java. I think in some places it might go too fast for beginners.
 
I agree. Here's the link: http://aspose.com/file-tools
 
subject: What is a "javadoc utility" and good documentation?