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

Generate warning for wrong @param tag order

XMLWordPrintable

    • Icon: Enhancement Enhancement
    • Resolution: Unresolved
    • Icon: P4 P4
    • tbd
    • 19
    • tools
    • Fix Understood
    • generic
    • generic

      Currently we generate warnings for missing or duplicate @param tags, but not when the order of tags differs from the order of declared parameters. Although with JDK-8234682 javadoc may get better at fixing parameter order in the generated documentation, it would be helpful to also issue a warning (or maybe informational notice) when tag order does not match the code.

      The check should be implemented in DocLint in order to be configurable.

            hannesw Hannes Wallnoefer
            hannesw Hannes Wallnoefer
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated: