Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-4780921

javadoctool: DocLocale.java has undesirable i18n implementation

XMLWordPrintable

    • tiger
    • generic
    • generic

      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}



            gafter Neal Gafter (Inactive)
            kurosaki Kenichi Kurosaki (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: