JDK-4780921 : javadoctool: DocLocale.java has undesirable i18n implementation
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.2
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2002-11-19
  • Updated: 2003-08-01
  • Resolved: 2003-08-01
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availabitlity Release.

To download the current JDK release, click here.
Other
5.0 tigerFixed
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
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: tiger FIXED IN: tiger INTEGRATED IN: tiger tiger-b14
2004-06-14

PUBLIC COMMENTS ...
2004-06-10

EVALUATION Should fix for beta. ###@###.### 2002-11-19
2002-11-19