208640 - Sun's javadoc by default generates UTF-7, links fail for bugzilla unless UTF-8 or ASCII

Status: RESOLVED WONTFIX

(Bugzilla :: Bugzilla-General, defect)

Description

[Jason Pyeron]

User-Agent:       Mozilla/4.0 (compatible; MSIE 5.5; Windows NT 5.0; .NET CLR 1.0.3705)
Build Identifier: 

Javadoc's like this will generate links the Internet Explorer cannot follow, 
since it assumes that local filesystem files are UTF-7 unless a UCS header is 
present.

 /**
 *
 * We are not caching this to disk.
 * @see <a href="http://bugzilla.mozilla.org/show_bug.cgi?id=207838#c5">BUG 
207838, COMMENT 5</a>
 *
 **/
 public static VersionTable getVersionTable(BugzillaSession bugzilla) throws 
SQLException

results in:

Not Found
The requested URL /show+AF8-bug.cgi was not found on this server.


--------------------------------------------------------------------------------

Apache/1.3.26 Server at bugzilla.mozilla.org Port 80


SOLUTION:

explicitly set the charset or file encoding, like...

 javadoc -charset="UTF-8"

Reproducible: Always

Steps to Reproduce:

Comment 1

[Jason Pyeron]

This is NOT a problem with bugzilla, but rather this is the place where people 
can find information on how to fix this IE -> apache/IIS interaction when a 
bugzilla link is generate by Sun's javadoc tool.

This problem may also exist in other vendors' javadoc tools.

I will post links to Sun's bug report for this if I can find/create one.

-- Dave do you want to make the owner on this one?

Comment 2

[Jason Pyeron]

-

Comment 3

[Jason Pyeron]

their bug system is a nightmare!

http://developer.java.sun.com/developer/bugParade

Date: Sat, 7 Jun 2003 14:34:49 -0600 (MDT)
From: "[e-mail]" <[e-mail]>
To: [e-mail]
Subject: Your Report: Sun's javadoc by default generates UTF-7,
     links fail for Apache

************************************************
Your report has been assigned an internal review ID of: 187402

This review ID is NOT visible on the "Java Developer Connection" (JDC).

We greatly appreciate your interest in improving the quality
of Java(tm) Technology from Sun Microsystems.

Please be aware that the large volume of reports we receive
sometimes prevents us from responding individually to each
message.

We currently have a three week response time for responding to
Bug Reports.  If the information is determined to be a new bug,
or a duplicate of a known bug, you will receive a followup email
containing a seven digit bug number.  You may search for this bug
number on the "Java Developer Connection" (JDC) at this URL:
http://developer.java.sun.com/developer/bugParade/index.html.

If you just reported an issue that could have a major
impact on your project and you require a response,
please consider purchasing one of the support offerings
at this URL:
    http://java.sun.com/support/index.html
------------------------------------------------------
dateCreated: Sat Jun 07 14:34:47 MDT 2003
type:        bug
cust_name:   Jason Pyeron
cust_email:  [e-mail]
jdcid:       jpyeron
status:      Waiting
category:    java
subcategory: javadoc
company:     Pyerotechnics Development, Inc.
release:     1.4.1
hardware:    x86
OSversion:   windows_2000
priority:    4
synopsis:    Sun's javadoc by default generates UTF-7, links fail for Apache
description: 

...