Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4359874
Votes 0
Synopsis stddoclet: -linkoffline mistakenly inserts '\' instead of '/' in URL on Windows
Category doclet:tbd
Reported Against 1.2
Release Fixed 1.4(merlin-beta)
State 10-Fix Delivered, bug
Priority: 3-Medium
Related Bugs 4511110
Submit Date 04-AUG-2000
Description
I have fixed this bug.

 xxxxx@xxxxx  2001-02-28I am observing a behavior in JavaDoc which I would classify as a bug.
However, it might be that I'm missing something.

I'm using -linkoffline option for enabling links from my documentation to the
standard JDK classes. This option accepts extdocURL parameter which it uses
as a prefix for making hyperlinks to the external documentation. After that a
pathname separator is placed and a path to the specific HTML page. I'm
running JavaDoc on Windows NT. Because of this (I guess) JavaDoc uses
backslash (\) as a separator between the basepath to the ext docs and the
tail. 

For example, if my class com.mycompany.mypackage.MyClass extends
javax.swing.JTable, and assuming I run javadoc -linkoffline ../JDK/docs/api
/JDK/docs/api, the result would be:
../../../../JDK/docs/api\javax/swing/JTable.html Pay attention to the
backslash in the middle. Everything would be nice, were Windows NT the only
platform in the world. This is, however, not true. For reasons, not relevant
to this discussion, I'm using Apache on Unix as a Web server for viewing the
generated documentation. Since use of backslash is not standard in HTML,
links of this kind do not work. Would be happy to hear a possible workaround.

Technical info:

java version "1.3.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0-C)
Java HotSpot(TM) Client VM (build 1.3.0-C, mixed mode)

javadoc -d \Qbuild\doc -sourcepath \Q
     -classpath \Qbuild\class
     -linkoffline ../JDK/docs/api /JDK/docs/api <package-name>
(the command is split into lines for readability)

Thank you for your attention.
Work Around
N/A
Evaluation
Important for Windows users, as it causes broken links.
 xxxxx@xxxxx  2000-09-07

I have fixed this bug.  Location of bug fix:

Extern.adjustEndFileSeparator()

 xxxxx@xxxxx  2001-02-28
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang