JDK-8173425 : Javadoc needs a new tag to specify the summary.
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 9
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • OS: generic
  • CPU: generic
  • Submitted: 2017-01-27
  • Updated: 2018-02-08
  • Resolved: 2017-08-15
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 10
10 b20Fixed
Related Reports
CSR :  
Duplicate :  
Relates :  
Sub Tasks
JDK-8186403 :  
Currently in javadoc the summary (firstsentence) of an element is deciphered by a dot-space rule, or if required using BreakIterator.

It is hard to sometimes guess the users intention, and BreakIterator
can be complex and slow when used with other languages, which does not use the English grammar rules.

For all the reasons, instead of guessing the intentions we should provide a new tag ex:

{@summary This is the first sentence.} This is the second sentence.

Then it becomes crystal clear what the summary sentence(s) should be.