-
Bug
-
Resolution: Fixed
-
P3
-
9
-
b38
Issue | Fix Version | Assignee | Priority | Status | Resolution | Resolved In Build |
---|---|---|---|---|---|---|
JDK-8194619 | 11 | Jonathan Gibbons | P3 | Resolved | Fixed | b01 |
JDK-8194784 | 10.0.1 | Jonathan Gibbons | P3 | Resolved | Fixed | b01 |
Colleague Tobias Thierer reports:
---
There seems to be a behavior change / bug in the javadoc tool in OpenJDK 9 relative to OpenJDK 8 when the backslash character \ occurs in javadoc.
For example, in java.io.File, the javadoc:
* directory, or <code>"\\\\"</code> for a Microsoft Windows UNC pathname, and
becomes [Java 8 docs]:
https://docs.oracle.com/javase/8/docs/api/java/io/File.html
directory, or "\\\\" for a Microsoft Windows UNC pathname, and
vs. [Java 9 docs]:
http://download.java.net/java/jdk9/docs/api/java/io/File.html
directory, or "\\\" for a Microsoft Windows UNC pathname, and
(with an obvious and unintended change in meaning)
----
Where the \ appears at the end of the line, then the following line's '*' gets erroneously included in the .html. For example, in java.util.Properties, the javadoc:
* fruits apple, banana, pear, \
* cantaloupe, watermelon, \
* kiwi, mango
becomes [Java 8 docs]
https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html
fruits apple, banana, pear, \
cantaloupe, watermelon, \
kiwi, mango
vs. [Java 9 docs]:
http://download.java.net/java/jdk9/docs/api/java/util/Properties.html
fruits apple, banana, pear, \
* cantaloupe, watermelon, \
* kiwi, mango
---
There seems to be a behavior change / bug in the javadoc tool in OpenJDK 9 relative to OpenJDK 8 when the backslash character \ occurs in javadoc.
For example, in java.io.File, the javadoc:
* directory, or <code>"\\\\"</code> for a Microsoft Windows UNC pathname, and
becomes [Java 8 docs]:
https://docs.oracle.com/javase/8/docs/api/java/io/File.html
directory, or "\\\\" for a Microsoft Windows UNC pathname, and
vs. [Java 9 docs]:
http://download.java.net/java/jdk9/docs/api/java/io/File.html
directory, or "\\\" for a Microsoft Windows UNC pathname, and
(with an obvious and unintended change in meaning)
----
Where the \ appears at the end of the line, then the following line's '*' gets erroneously included in the .html. For example, in java.util.Properties, the javadoc:
* fruits apple, banana, pear, \
* cantaloupe, watermelon, \
* kiwi, mango
becomes [Java 8 docs]
https://docs.oracle.com/javase/8/docs/api/java/util/Properties.html
fruits apple, banana, pear, \
cantaloupe, watermelon, \
kiwi, mango
vs. [Java 9 docs]:
http://download.java.net/java/jdk9/docs/api/java/util/Properties.html
fruits apple, banana, pear, \
* cantaloupe, watermelon, \
* kiwi, mango
- backported by
-
JDK-8194619 Bad lexing of javadoc comments (change in parsing/rendering of backslashes in javadoc)
-
- Resolved
-
-
JDK-8194784 Bad lexing of javadoc comments (change in parsing/rendering of backslashes in javadoc)
-
- Resolved
-
- relates to
-
JDK-4910483 Javadoc renders the string ".*\\.pdf" as ".\*\.pdf"
-
- Closed
-