JDK-8075275 : javadocs incorrectly parses FirstSentence tags.
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 9
  • Priority: P3
  • Status: Open
  • Resolution: Unresolved
  • OS: generic
  • CPU: generic
  • Submitted: 2015-03-16
  • Updated: 2018-10-23
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
Related Reports
Relates :  
Description
Supposing we have:
    /**
     * <pre>
     * Result:  {@value pkg1.Class1#TEST_8_PASSES}
     * Result:  {@value pkg2.Class3#TEST_13_PASSES}
     * </pre>
     */
    public int field; 

The first sentence tags array contains the contents of <pre> along
with the Html attribute. 
This is even worse with this case:
 * <pre>
 * This is a sentence.
 * This is another sentence.
 * </pre>
Where the first sentence tags contains only 
<pre> This is another sentence.
Causing malformed tags.

Therefore the "<" must be regarded as a break.

Comments
http://hg.openjdk.java.net/jdk9/dev/jdk/file/13a1aaa9598f/src/java.desktop/share/classes/java/awt/im/package.html#l34
16-03-2015

Currently, the spec is that block tags are intended to be the break. For example, <p>, <pre> We need to allow the use of inline HTML tags within the first sentence, as in /** * This is the <b>first</b> sentence. * This is the <b>second</b> sentence. */ Changing to prevent any HTML tag within the first sentence would be too big of an incompatible change.
16-03-2015