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

bogus doclint error with newline in method declaration

    Details

      Description

      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.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              webbuggrp Webbug Group
            • Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: