-
Bug
-
Resolution: Incomplete
-
P3
-
8u5
-
x86_64
-
linux
FULL PRODUCT VERSION :
java version "1.8.0_05"
Java(TM) SE Runtime Environment (build 1.8.0_05-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed mode)
ADDITIONAL OS VERSION INFORMATION :
Linux construction 3.14.1-gentoo #5 SMP PREEMPT Fri Apr 25 18:36:13 CDT 2014 x86_64 Intel(R) Core(TM) i7-2760QM CPU @ 2.40GHz GenuineIntel GNU/Linux
A DESCRIPTION OF THE PROBLEM :
The new doclint produces a bogus "error: @param name not found" when there is a newline immediately after the open parenthesis following a method name. Removing the syntactically irrelevant newline (so that the parameter declaration immediately follows the parenthesis character) removes the doclint error.
REGRESSION. Last worked in version 7u60
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Define "@param foo description" in a Javadoc block on a method. Insert a new line after the method's opening parenthesis before "int foo".
EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Javadoc compiles normally.
ACTUAL -
doclint complains about a missing parameter.
REPRODUCIBILITY :
This bug can be reproduced always.
CUSTOMER SUBMITTED WORKAROUND :
Remove newline.
java version "1.8.0_05"
Java(TM) SE Runtime Environment (build 1.8.0_05-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed mode)
ADDITIONAL OS VERSION INFORMATION :
Linux construction 3.14.1-gentoo #5 SMP PREEMPT Fri Apr 25 18:36:13 CDT 2014 x86_64 Intel(R) Core(TM) i7-2760QM CPU @ 2.40GHz GenuineIntel GNU/Linux
A DESCRIPTION OF THE PROBLEM :
The new doclint produces a bogus "error: @param name not found" when there is a newline immediately after the open parenthesis following a method name. Removing the syntactically irrelevant newline (so that the parameter declaration immediately follows the parenthesis character) removes the doclint error.
REGRESSION. Last worked in version 7u60
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Define "@param foo description" in a Javadoc block on a method. Insert a new line after the method's opening parenthesis before "int foo".
EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
Javadoc compiles normally.
ACTUAL -
doclint complains about a missing parameter.
REPRODUCIBILITY :
This bug can be reproduced always.
CUSTOMER SUBMITTED WORKAROUND :
Remove newline.