Javadoc for free
If you ever downloaded the Java SDK from Sun’s site, you more or less
had to download the Javadoc separately, meaning the documentation for Java’s core API.
That’s understandable. Even compressed, the 1.4.1_02 documentation takes up a full 33 MB.
The whole package, SDK and documentation together, would be close to 80 MB. That’s no small download.
For Michael Nascimento Santos the issue apparently was getting hold of the documentation,
rather than download speed, so he took a straightforward approach. The API documentation is generated from source files
that already contain the API’s Javadoc comments. The SDK comes with source code, so
Michael Nascimento Santos wrote a simple Ant script that generates the documentation from it using
standard Java tools. He published it all in his post Building javadoc from J2SDK source code
Related articles
Related CZ Podcast episodes
- #3 · Java 6 SE, Vývoj webových aplikací
Dagi and Filemon discuss Java 6 and web application frameworks. · Czech audio
- #1 · Vývojová prostředí v Javě
The first CZ Podcast episode looks at Java development environments. · Czech audio