-
Bug
-
Resolution: Cannot Reproduce
-
P4
-
1.4.1
-
x86
-
linux
Name: nt126004 Date: 03/17/2003
FULL PRODUCT VERSION :
java version "1.4.1_02"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_02-b06)
Java HotSpot(TM) Client VM (build 1.4.1_02-b06, mixed mode)
FULL OS VERSION :
Linux user.jkf 2.4.18-24.8.0 #1 Fri Jan 31 07:28:55 EST 2003 i686 athlon i386 GNU/Linux
(RedHat 8)
A DESCRIPTION OF THE PROBLEM :
Javadoc does warn that the   hack (or <!-- -->) as described in
http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
is not supported anymore as of the next version and when using -breakiterator.
Worse in case of inline comments in HTML overview / package files it recognizes the ! of <!-- as the end of scentence!
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
Make a javadoc comment . package.html / overview.html file with in it a .  X followed by a capital in the first scentence of a description.
EXPECTED VERSUS ACTUAL BEHAVIOR :
I would expect the suggestions in the descriptions keep working, especially the part.
[javadoc] "This is an example containing the name J.M. Kruithof."
[javadoc] This sentence is different from what will be interpreted as the first sentence in the
[javadoc] next major release (when that interpretation will be internationalized),
which is:
[javadoc] "This is an example containing the name J.M."
[javadoc] To avoid this note, change the doc comment to make this a proper first sentence, then
[javadoc] use -breakiterator from that point forward, which will output this new sentence.
REPRODUCIBILITY :
This bug can be reproduced always.
---------- BEGIN SOURCE ----------
package.html:
<html>
<head></head>
<body>
This is an example containing the name J.M. Kruithof.
</body>
</html>
---------- END SOURCE ----------
(Review ID: 182706)
======================================================================