Bug ID: JDK-8185329 No documentation for "-packagesheader" command-line option for javadoc

Type: Bug
Component: tools
Sub-Component: javadoc(tool)
Affected Version: 6,7,8

Priority: P4
Status: Open
Resolution: Unresolved
OS: windows_7
CPU: x86_64

Submitted: 2017-07-25
Updated: 2018-10-23

Versions (Unresolved/Resolved/Fixed)

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.

Other
tbd_minorUnresolved

A DESCRIPTION OF THE PROBLEM :
The "-packagesheader" option for javadoc was apparently added a long time ago, but it's never been documented.  I found http://bugs.java.com/bugdatabase/view_bug.do?bug_id=4770521 .  I would add an additional comment to that, but I don't have that ability.

Because of the lack of this documentation, other tools that interface with javadoc have not implemented an interface for this option, so the problem is cascading.


URL OF FAULTY DOCUMENTATION :
http://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html#options