JDK-8073100 : [javadoc] Provide an ability to suppress document generation for specific elements.
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 9
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2015-02-12
  • Updated: 2017-05-17
  • Resolved: 2016-04-10
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 9
9 b114Fixed
Related Reports
Blocks :  
JDK-8029891 - Deadlock detected in java/lang/ClassLoader/deadlock/GetResource.java
Duplicate :  
JDK-4102647 - stddoclet: Consider making @internal a standard tag
Description
The javadoc tag @treatAsPrivate was added for the benefit of JavaFX documentation.
However, there are enough requests from others who also have need for such tag. 
Therefore, we should formalize (i.e. document) the flag and expose it for general use.
Comments
http://mail.openjdk.java.net/pipermail/javadoc-dev/2016-April/000192.html
06-04-2016
We would be interested in having @nodoc for JDK-8029891.
05-06-2015
Would also be interesting to consider @nodoc. @treatAsPrivate wil hide the method from the list of inherited methods as well. Sometimes, you may be just overriding a method, with no user-visible change in behavior, and would prefer the output to be as though you hadn't overridden the method. An alternate solution is to reconsider the merits of defaulting @inheritDoc when no comment is provided and/or provide a way to parameterize @inheritDoc.
03-06-2015