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

The @value tag is broken when used more than once in a single javadoc comment.

    • Icon: Enhancement Enhancement
    • Resolution: Duplicate
    • Icon: P4 P4
    • None
    • 1.4.1
    • tools



      Name: rmT116609 Date: 09/26/2002


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

      Microsoft Windows 2000 [Version 5.00.2195]

      DESCRIPTION OF THE PROBLEM :
      The @value tag is broken when used more than once in a single Javadoc comment.

      Generating Javadoc for the following:

      /**
       * STRING_1={@value #STRING_1} STRING_2={@value #STRING_2}
       */
      static final String STRING_1 = "String1";

      /**
       * STRING_2={@value #STRING_2} STRING_1={@value #STRING_1}
       */
      static final String STRING_2 = "String2";

      ..produces the following output:

       STRING_1="String1" STRING_2="String1"
       STRING_2="String2" STRING_1="String2"

      STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
      1. Use two @value to render more than one constant in a single Javadoc comment.
      2. Generate the Javadoc.


      EXPECTED VERSUS ACTUAL BEHAVIOR :
      Expected:
      STRING_1="String1" STRING_2="String2"
      STRING_2="String2" STRING_1="String1"

      Actual:
      STRING_1="String1" STRING_2="String1"
      STRING_2="String2" STRING_1="String2"

      REPRODUCIBILITY :
      This bug can be reproduced always.

      ---------- BEGIN SOURCE ----------
      public class TestOfJavaDoc {

      /**
      * STRING_1={@value #STRING_1} STRING_2={@value #STRING_2}
      */
      public static final String STRING_1 = "String1";

      /**
      * STRING_2={@value #STRING_2} STRING_1={@value #STRING_1}
      */
      public static final String STRING_2 = "String2";

      }

      ---------- END SOURCE ----------
      (Review ID: 158905)
      ======================================================================

            Unassigned Unassigned
            rmandalasunw Ranjith Mandala (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated:
              Resolved:
              Imported:
              Indexed: