HTML generated by JavaDoc

[Roedy Green]

JavaDoc uses URLs like this:

file://localhost/J:/Program%20Files/java/jdk1.5.0_05/docs/api/java/io/PrintWriter.html#printf(java.lang.String,
java.lang.Object...)

note the space after String,

Isn't that a bug?

1. HTML validator complains about it.

2. when I replace the space with %20, Opera and IE don't go to the
right place. Netscape, Mozilla and Firefox do.

3. Only alphanumeric characters and dashes are permitted in anchors,
so the dots, commas ( etc are all illegal.

3. even the space encoded with %20 is illegal.

 

[Roedy Green]

3. Only alphanumeric characters and dashes are permitted in anchors,
so the dots, commas ( etc are all illegal.

I have come up dry trying to find where the W3C hides the official
definition of what letters are allowed in anchors.

I have found two non-official sources with conflicting restrictions.

 

[David Gilbert]

JavaDoc uses URLs like this:

file://localhost/J:/Program%20Files/java/jdk1.5.0_05/docs/api/java/io/PrintWriter.html#printf(java.lang.String,
java.lang.Object...)

note the space after String,

Isn't that a bug?

Yes it is:

http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4663254

Gjdoc (a Free tool that does a similar job to Javadoc) can generate valid HTML, but
unfortunately it doesn't render well with Internet Explorer (it looks great in most
other browsers). Here's a sample:

http://www.jfree.org/jfreechart/api/

....and the validation:

http://validator.w3.org/check?uri=http://www.jfree.org/jfreechart/api/

Regards,

Dave Gilbert
JFreeChart Project Leader

 

[Roedy Green]

Gjdoc (a Free tool that does a similar job to Javadoc) can generate valid HTML, but
unfortunately it doesn't render well with Internet Explorer (it looks great in most
other browsers). Here's a sample:

http://lists.gnu.org/archive/html/cp-tools-discuss/2005-04/msg00002.html