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: 4661481
Votes 57
Synopsis REGRESSION: -encoding option is ignored for reading java sources
Category doclet:tbd
Reported Against 1.4
Release Fixed 1.4.1(hopper)
State 10-Fix Delivered, bug
Priority: 3-Medium
Related Bugs
Submit Date 02-APR-2002
Description




FULL PRODUCT VERSION :
java version "1.4.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)


FULL OPERATING SYSTEM VERSION :
SunOS java 5.8 Generic_108528-12 sun4u sparc SUNW,Ultra-2

ADDITIONAL OPERATING SYSTEMS :

Windows 2000, Windows 98 (Probably this bug is
platform-independent)

EXTRA RELEVANT SYSTEM CONFIGURATION :
Japanese language environments

A DESCRIPTION OF THE PROBLEM :
When -encoding option is specified to javadoc, Java source
codes can't be converted correctly. So Japanese characters
are converted to "???????".

For example, this problem occurs when you convert Java
source files encoded in Shift_JIS on Japanese Solairs EUC-JP
environment with "-encoding Shift_JIS".

Perhaps javadoc may convert Java sources in according to its
default character encoding, not an encoding specified by
"-encoding" option.

I guess this bug was included when you fixed Bug ID 4463408
from the following reasons:

1, In 1.4b, javadoc can convert java sources correctly, but
not package.html.
2, In 1.4b2, javadoc can convert package.html correctly, but
not java sources.
3, Bug ID 4463408 was fixed in 1.4b2.

REGRESSION.  Last worked in version 1.3.1

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1.Create a Java source file encoded in a character encoding
which isn't equal to javadoc's default character encoding.
For example, use EUC-JP on Japanese Windows platform and use
Shift_JIS on Japanese Solaris platform.
2.Run javadoc with "-encoding" and Java source's character
encoding.
3.Check the output.

EXPECTED VERSUS ACTUAL BEHAVIOR :
When "-encoding" option is specified, Javadoc should read
Java sources and package.html in according to it.

Now javadoc ignores "-encoding" option and reads Java
sources in according to its default character encoding and
produces currupted character sequences such as "??????".

ERROR MESSAGES/STACK TRACES THAT OCCUR :
No error message.

This bug can be reproduced always.

CUSTOMER WORKAROUND :
Convert Java sources to the default character encoding use
in your environment.

Release Regression From : merlin-beta
The above release value was the last known release where this 
bug was known to work. Since then there has been a regression.

(Review ID: 144520) 
======================================================================
Work Around
N/A
Evaluation
Would be important to fix for hopper
  xxxxx@xxxxx   2002-04-02

This bug has been fixed.  Location of fix:

com.sun.tools.javadoc.Start

Regression test at:  test/com/sun/javadoc/testEncoding/testEncodingWrapper.sh
  xxxxx@xxxxx   2002-04-22
Comments
  
  Include a link with my name & email   

Submitted On 03-APR-2002
hidehaya
I hope that this bug will be fixed soon.


Submitted On 03-APR-2002
hidehaya
I hope that this bug will be fixed soon!


Submitted On 03-APR-2002
hidehaya
I hope that this bug will be fixed soon.


Submitted On 05-APR-2002
chiitake
I hope that this bug will be fixed soon.



PLEASE NOTE: JDK6 is formerly known as Project Mustang