Skip to main content

Please provide documentation drops with binaries

4 replies [Last post]
nwourms
Offline
Joined: 2005-02-16

The docs on java.sun.com are old! The online version from the main jdk6 page goes to 404, but that isn't the point. New features and not unsubstantial changes require new api documentation drops. The jdk7 project has no problem providing doc drops with new binaries, I think jdk6 should as well.

Reply viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.
rogyeu
Offline
Joined: 2006-07-30

When 6u10 (6uN) is available on java.sun.com, we will provide the usage information about how to use these new features.

In the meanwhile, you can still visit https://jdk6.dev.java.net/6uNea.html for information and usage about the new features.

Thanks,
Roger Y.

trembovetski
Offline
Joined: 2003-12-31

There supposed to be no changes in jdk6 requiring updates to the public API, thus
the docs from Java 6 are just as relevant:
http://java.sun.com/javase/6/docs/api/index.html

Dmitri

nwourms
Offline
Joined: 2005-02-16

That is not true, there are significant changes since it was last built. What about new/changed parameters for the JVM? What about Nimbus? What about D3D? The new plugin? The new deployment stuff? I could go on and on.

Here's the time stamp at that url: "Generated by javadoc (build 1.6.0) on Wed Nov 29 02:28:47 PST 2006"

Old docs are old. Like I said, JDK7 folks have no problem providing fresh doc drops, why should jdk6uN be any different?

trembovetski
Offline
Joined: 2003-12-31

> That is not true, there are significant changes since it was last built.

There are NO changes to the public API though. Which is what the API javadoc
is supposed to document (or specify - depends on your pov).

> JDK7 folks have no problem providing fresh doc drops,

That is because in JDK7 there are changes to the public API.

Dmitri