-
Enhancement
-
Resolution: Duplicate
-
P4
-
None
-
1.4.1
-
x86
-
windows_2000
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)
======================================================================
- duplicates
-
JDK-4753737 stddoclet: Allow {@value} to take field name arg and be used in any doc comment
-
- Closed
-