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

Javadoc an enum under simplified chinese locale causes warning

    Details

    • Subcomponent:
    • Resolved In Build:
      b110
    • CPU:
      x86
    • OS:
      linux

      Description

      FULL PRODUCT VERSION :
      mustang b99

      ADDITIONAL OS VERSION INFORMATION :
      Linux localhost.localdomain 2.6.9-11.19WS

      A DESCRIPTION OF THE PROBLEM :
      javadoc an enum under simplified chinese locale. This problem can be reproduced by any java source files. The Warning message is:
      @XX is an unknown tag. ( the message was in chinese.)

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      javadoc any enum under simplified chinese locale.
      This is the command of javadoc:
      javadoc -protected -sourcepath "C:\FOP Wrapper\src" -encoding GB18030
      -source 1.5 -d "C:\FOP Wrapper\javadoc" -charset GB18030 -docencoding
      GB18030 "C:\FOP Wrapper\src\com\panda\report\common\CELLTYPE.java"

      The "@return" tag in the resource file(doclets_zh_CN.properties) was translated into Chinese which I think should be remained English.....

      in the j2se/src/share/classes/com/sun/tools/doclets/internal/tookit/resource/doclets_zh_CN.properties english version:
      doclet.enum_values_doc=
      ...
      ...
      @return an array containing the constants of this enum type,in \n...
      chinese version:
      @XXXXXXXXXXXXXXXXXXXXXXXXX(chinese characters)
      even the "@return" was translated!

      REPRODUCIBILITY :
      This bug can be reproduced always.

      ---------- BEGIN SOURCE ----------
      CELLTYPE.java

      public enum CELLTYPE {
          NORMAL(0),
          PAGENO(1),
          PAGECOUNT(2),
          ;

          private final int value;

          CELLTYPE(int value) {
              this.value = value;
          }

          @Override
          public String toString() {
              switch (value) {
              case 0:
                  return "0";
              case 1:
                  return "1";
              case 2:
                  return "2";
              }
              return "";
          }
      }
      ---------- END SOURCE ----------

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                mfang Michael Fang (Inactive)
                Reporter:
                ndcosta Nelson Dcosta (Inactive)
              • Votes:
                0 Vote for this issue
                Watchers:
                3 Start watching this issue

                Dates

                • Due:
                  Created:
                  Updated:
                  Resolved:
                  Imported:
                  Indexed: