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

doclint should report implicit constructor as missing javadoc comments

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Fixed
    • Icon: P3 P3
    • 18
    • 15
    • tools

      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

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

              Created:
              Updated:
              Resolved: