JDK-8274295 : Update the javadoc man page to reflect JDK 17 changes
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 17
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2021-09-24
  • Updated: 2021-12-13
  • Resolved: 2021-11-16
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 18
18 b24Fixed
Related Reports
Relates :  
JDK-8263468 - New page for "recent" new API
Relates :  
JDK-8274211 - Test man page that options are documented
Description
Several new command line options were added to `javadoc` with the JDK 17 release, however the javadoc tool spec page does not provide descriptions 
`--since`
`--since-label` 
`--legal-notices`

Descriptions provided from help output of command line tool.

Recent API:
```
    --since <release>(,<release>)*
                  Document new and deprecated API in the specified releases
    --since-label <text>
                  Provide text to use in the heading of the "New API" page
```

legal-notices:
```
    --legal-notices 'default' | 'none' | <directory>
                  Control legal notices in the generated output
```