Details

    • Type: Sub-task
    • Status: Closed
    • Priority: P4
    • Resolution: Duplicate
    • Affects Version/s: None
    • Fix Version/s: tbd_major
    • Component/s: tools
    • Labels:
      None

      Description

      javadoc will need to be enhanced in a variety of ways to handle the enhanced deprecation annotations. Of particular note is the new forRemoval element of the @Deprecated annotation. There are a couple ideas:

      1) Change the wording of the text that's inserted into the specification of an API that is deprecated for removal. The wording should make clear that the API is to be removed, and it should be made stronger. The formatting could also be changed in order to attract more attention.

      2) The list of deprecated APIs should note the forRemoval status of the API as well as displaying the text of the "since" element of the @Deprecated annotation.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                smarks Stuart Marks
              • Votes:
                0 Vote for this issue
                Watchers:
                2 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved:

                  Time Tracking

                  Estimated:
                  Original Estimate - Not Specified
                  Not Specified
                  Remaining:
                  Remaining Estimate - 2 weeks
                  2w
                  Logged:
                  Time Spent - 0 minutes
                  0m