HTML generated by JavaDoc

Thread view:

Roedy Green - 26 Nov 2005 18:22 GMT

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.

Signature

Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.

Reply to this Message

Roedy Green - 26 Nov 2005 18:32 GMT

On Sat, 26 Nov 2005 18:22:00 GMT, Roedy Green
<my_email_is_posted_on_my_website@munged.invalid> wrote, quoted or
indirectly quoted someone who said :

>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.

Signature

Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.

Reply to this Message

David Gilbert - 26 Nov 2005 19:18 GMT

> JavaDoc uses URLs like this:
>
[quoted text clipped - 4 lines]
>
> 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%3A%2F%2Fwww.jfree.org%2Fjfreechart%2Fapi%2F

Regards,

Dave Gilbert
JFreeChart Project Leader

Reply to this Message

Roedy Green - 26 Nov 2005 21:16 GMT

On Sat, 26 Nov 2005 19:18:15 GMT, David Gilbert
<david.gilbert@ntlworld.com> wrote, quoted or indirectly quoted
someone who said :

>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

Signature

Canadian Mind Products, Roedy Green.
http://mindprod.com Java custom programming, consulting and coaching.

Reply to this Message

HTML generated by JavaDoc

Free Magazines