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

doclint should report implicit constructor as missing javadoc comments

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: 15
    • Fix Version/s: 18
    • Component/s: tools
    • Labels:

      Description

      If a class has an explicit constructor with no javadoc comments, then running "javadoc -Xdoclint:missing" will produce a warning regarding the missing comments. If, however, no constructor is defined in the source file, which will cause an implicit no-arg constructor to be generated, no warning is generated. Since the implicit constructor will not have any documentation (same as in the explicit case), it would be nice to produce a warning.

      To reproduce this, run the attached program as follows:

      javadoc -d build --source-path src -Xdoclint:missing pkg

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              jjg Jonathan Gibbons
              Reporter:
              kcr Kevin Rushforth
              Votes:
              0 Vote for this issue
              Watchers:
              5 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: