United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-4780921 javadoctool: DocLocale.java has undesirable i18n implementation
JDK-4780921 : javadoctool: DocLocale.java has undesirable i18n implementation

Details
Type:
Bug
Submit Date:
2002-11-19
Status:
Resolved
Updated Date:
2003-08-01
Project Name:
JDK
Resolved Date:
2003-08-01
Component:
tools
OS:
generic
Sub-Component:
javadoc(tool)
CPU:
generic
Priority:
P3
Resolution:
Fixed
Affected Versions:
1.4.2
Fixed Versions:
5.0 (tiger)

Related Reports

Sub Tasks

Description
src/share/javac/com/sun/tools/javadoc/DocLocale.java:
line 168-
--------------------------
            if (!printedLongBreakIteratorWarning) {
                    docenv.warning(doc, "javadoc.BreakIterator_Error_Long_0");
                    docenv.notice("javadoc.BreakIterator_Error_Long_1", oldResult);
                    docenv.notice("javadoc.BreakIterator_Error_Long_2");
                    docenv.notice("javadoc.BreakIterator_Error_Long_3");
                    docenv.notice("javadoc.BreakIterator_Error_Long_4", result);
                    docenv.notice("javadoc.BreakIterator_Error_Long_5");
                    docenv.notice("javadoc.BreakIterator_Error_Long_6");
                    printedLongBreakIteratorWarning = true;
            } else {
                docenv.warning(doc, "javadoc.BreakIterator_Error_Short_0");
                    docenv.notice("javadoc.BreakIterator_Error_Short_1", oldResult);
                    docenv.notice("javadoc.BreakIterator_Error_Short_2");
                    docenv.notice("javadoc.BreakIterator_Error_Short_3", result);
            }
--------------------------

src/share/javac/com/sun/tools/javadoc/resources/javadoc.properties:
line 83-
--------------------------
javadoc.BreakIterator_Error_Long_0=The first sentence is interpreted to be:
javadoc.BreakIterator_Error_Long_1="{0}"
javadoc.BreakIterator_Error_Long_2=This sentence is different from what will be interpreted as the first sentence in the
javadoc.BreakIterator_Error_Long_3=next major release (when that interpretation will be internationalized), which is:
javadoc.BreakIterator_Error_Long_4="{0}"
javadoc.BreakIterator_Error_Long_5=To avoid this note, change the doc comment to make this a proper first sentence, then
javadoc.BreakIterator_Error_Long_6=use -breakiterator from that point forward, which will output this new sentence.
javadoc.BreakIterator_Error_Short_0=The first sentence is interpreted to be:
javadoc.BreakIterator_Error_Short_1="{0}"
javadoc.BreakIterator_Error_Short_2=This sentence is different from what would be generated using -breakiterator: 
javadoc.BreakIterator_Error_Short_3="{0}"
--------------------------

Dividing a text into some parts and extracting only variables
is not correct i18n.  These messages cannot be translated properly,
especially in Asian locales.  The messages should be like:

            if (!printedLongBreakIteratorWarning) {
                    docenv.warning(doc, "javadoc.BreakIterator_Error_Long_0");
                    docenv.notice("javadoc.BreakIterator_Error_Long", oldResult, result);
                    printedLongBreakIteratorWarning = true;
            } else {
                    docenv.warning(doc, "javadoc.BreakIterator_Error_Short_0");
                    docenv.notice("javadoc.BreakIterator_Error_Short", oldResult, result);
            }

and

javadoc.BreakIterator_Error_Long_0=The first sentence is interpreted to be:
javadoc.BreakIterator_Error_Long={0}\nThis sentence is different from what will be interpreted as the first sentence in the\nnext major release (when that interpretation will be internationalized), which is:\n{1}\nTo avoid this note, change the doc comment to make this a proper first sentence, then\nuse -breakiterator from that point forward, which will output this new sentence.
javadoc.BreakIterator_Error_Short_0=The first sentence is interpreted to be:
javadoc.BreakIterator_Error_Short_1={0}\nThis sentence is different from what would be generated using -breakiterator:\n{1}




                                    

Comments
EVALUATION

Should fix for beta.

###@###.### 2002-11-19
                                     
2002-11-19
PUBLIC COMMENTS

...
                                     
2004-06-10
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
tiger

FIXED IN:
tiger

INTEGRATED IN:
tiger
tiger-b14


                                     
2004-06-14



Hardware and Software, Engineered to Work Together