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: 4511110
Votes 2
Synopsis stddoclet: -linksource option produces '\' in links when run on Windows
Category doclet:tbd
Reported Against merlin-beta2
Release Fixed 1.4.2(mantis)
State 10-Fix Delivered, bug
Priority: 4-Low
Related Bugs 4359874
Submit Date 04-OCT-2001
Description
The '\' character has been switched to the '/' character in the link.

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

Running javadoc on Windows with -linksource produces backslashes 
in links to source files. When viewing these files (that were
produced on Windows) on UNIX, the links appear broken. 
URLs in HTML should always be with forward slashes as 
path separator, no matter what platform javadoc is run on.

The pages produced by Javadoc are viewable on Windows and not viewable 
on Unix. The information about the -linksource can be found at

http://java.sun.com/j2se/1.4/docs/tooldocs/win32/javadoc.html#linksource

(Review ID: 133023) 
======================================================================
Work Around
N/A
Evaluation
This is a cross-platform bug.  When running javadoc on either Windows
or UNIX and displaying the documents on the same platform, no links
are broken.  However, we should fix this, because it is somewhat
common (outside Sun) for someone to run javadoc on Windows, and then
for UNIX users to want to view those documents.
 xxxxx@xxxxx  2001-12-08

I have fixed this bug.  The bug fix is pending review.
 xxxxx@xxxxx  2002-07-08
Comments
  
  Include a link with my name & email   

Submitted On 15-OCT-2001
victorbr
A possible workaround is to add an option -J-Dfile.separator=/ to javadoc.
However it is difficult to guess what side effects this might have.


Submitted On 08-MAR-2002
MartDesruisseaux
The evaluation is not 100% exact. When running javadoc on
Windows and displaying the documents on the same platform
(Windows), no links are broken with Internet Explorer but
links *are* broken with Mozilla. When running on Unix, the
documents can be displayed everywhere (both Unix and
Windows, using eithe Internet Explorer or Mozilla).


Submitted On 09-FEB-2005
JulianHyde
This bug is not completely fixed. Forward slashes are generated in the 'Field summary' section, and this is correct; but in the 'Field Detail' section, the fields still use backslashes.

See http://mondrian.sourceforge.net/api/mondrian/rolap/RolapConnectionProperties.html for an example of this.


Submitted On 10-FEB-2005
dhkramer
Thanks for reporting this.  I have opened a new bug:
6227914: -linksource option when run on Windows produces broken links when viewed on Solaris (due to '\')



PLEASE NOTE: JDK6 is formerly known as Project Mustang