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

javadoc warning on Text::tabSizeProperty method

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: openjfx14
    • Fix Version/s: openjfx14
    • Component/s: javafx
    • Labels:

      Description

      The new tabSize property in Text.java causes a javadoc warning during the build.

      To reproduce this, run:

      $ gradle javadoc

      > Task :javadoc
      /localhome/kcr/javafx/jfx-clean/jfx/rt/modules/javafx.graphics/src/main/java/javafx/scene/text/Text.java:1280: warning: no @return
          public final IntegerProperty tabSizeProperty() {
                                       ^
      1 warning

      The simple fix is to add:

      * @return the property

      One could argue that the doclet shouldn't give this warning, since it ignores anything you put in the @return anyway, but it's easier to add it to suppress the warning. I note that TextFlow doesn't have this problem because of the private field between the javadoc header and the property method.

        Attachments

          Issue Links

            Activity

              People

              Assignee:
              swpalmer Scott Palmer
              Reporter:
              kcr Kevin Rushforth
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved: