Tim Holloway wrote:The primary API documentation is JavaDocs. JavaDocs can be automatically produced by running the javadoc utility program against Java source code with specially-formatted comments. IDEs such as Eclipse can even run the javadoc on your own project source code.
The standard output from javadoc is a series of HTML pages suitable for hosting on a webserver. When Oracle releases a new version of Java, they generate JavaDocs and publish them on their own website.
For example: https://docs.oracle.com/javase/7/docs/api/index.html?java/sql/Date.html
The concept is actually older that Java. For example, When I developed for the Commodore Amiga back in the min-1980s, they had a similar system for C code called AutoDoc and their paper manuals were generated from there and then sent to their publisher (Addision-Wesley). I created a system of my own using scripts for C++ in the early 1990s. It output MS-Word Rich Text Format.
Non-Java systems these days often document themselves via a program called Doxygen. It lifts some of its features from JavaDoc.
And, incidentally, while most of the published JavaDocs you see are pretty sparing, you can, at your option add all sorts of secondary information, including HTML tables, graphics, and long rambling treatises. To be re-generated at will if you change the sources.
Campbell Ritchie wrote:That's a pleasure Did you get your installation to work?
Steve Yee wrote:. . . Thank you . . .
Campbell Ritchie wrote:Welcome to the Ranch
The book HFJ is now quite old, but they are planning a new edition. Sun no longer exist, so you will have to look elsewhere for your downloads. I haven't downloaded an API file for a long time, but this is where you will find the most recent API. Go here to download the JDK: go for the “ready for use JDK 15” link. Make sure you update your system/user PATH with the path to the new Java® installation at its beginning.
If you use Windows, tell us what you did and I might have to update our FAQ.