-
Bug
-
Resolution: Fixed
-
P2
-
None
Issue | Fix Version | Assignee | Priority | Status | Resolution | Resolved In Build |
---|---|---|---|---|---|---|
JDK-8084550 | emb-9 | Brian Burkhalter | P2 | Resolved | Fixed | team |
JDK-8234221 | openjdk8u242 | Brian Burkhalter | P2 | Resolved | Fixed | team |
JDK-8235168 | openjdk8u232 | Brian Burkhalter | P2 | Resolved | Fixed | master |
The change in JDK-8019857 creates a multi-line code sample delimited only by {@code, which gets scrunched into one line.
http://docs.oracle.com/javase/8/docs/api/java/util/Formattable.html
The entire jdk javadoc should be audited for similar misformatted code samples, and the current blessed idiom (btw, where is that documented?) for code samples applied.
--- a/src/share/classes/java/util/Formattable.java
+++ b/src/share/classes/java/util/Formattable.java
@@ -36,7 +36,7 @@
* For example, the following class prints out different representations of a
* stock's name depending on the flags and length constraints:
*
- * <blockquote><pre>
+ * {@code
* import java.nio.CharBuffer;
* import java.util.Formatter;
* import java.util.Formattable;
http://docs.oracle.com/javase/8/docs/api/java/util/Formattable.html
The entire jdk javadoc should be audited for similar misformatted code samples, and the current blessed idiom (btw, where is that documented?) for code samples applied.
--- a/src/share/classes/java/util/Formattable.java
+++ b/src/share/classes/java/util/Formattable.java
@@ -36,7 +36,7 @@
* For example, the following class prints out different representations of a
* stock's name depending on the flags and length constraints:
*
- * <blockquote><pre>
+ * {@code
* import java.nio.CharBuffer;
* import java.util.Formatter;
* import java.util.Formattable;
- backported by
-
JDK-8084550 javadoc of Formattable messed up by JDK-8019857
- Resolved
-
JDK-8234221 javadoc of Formattable messed up by JDK-8019857
- Resolved
-
JDK-8235168 javadoc of Formattable messed up by JDK-8019857
- Resolved
- relates to
-
JDK-8019857 Fix doclint errors in java.util.Format*
- Closed