-
Bug
-
Resolution: Fixed
-
P4
-
9
-
b169
-
generic
-
generic
-
Not verified
Issue | Fix Version | Assignee | Priority | Status | Resolution | Resolved In Build |
---|---|---|---|---|---|---|
JDK-8180238 | 10 | Bradford Wetmore | P4 | Resolved | Fixed | b08 |
The following:
http://hg.openjdk.java.net/jdk9/dev/jdk/file/6dea581453d7/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java#l49
Has open < and > characters, for normal doc production this is not an issue as this class in package private,
however for folks trying to build with -package or -private javadoc options, this issue will likely to cause issues.
The fix is simple either replace those characters with HTML entities
or surround that example snippet with {@code ......}
A possible patch
diff --git a/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java b/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java
--- a/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java
+++ b/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java
@@ -46,10 +46,12 @@
*
* The format of a permission entry in the jurisdiction policy file is:
*
+ * {@code
* permission <crypto permission class name>[, <algorithm name>
* [[, <exemption mechanism name>][, <maxKeySize>
* [, <AlgrithomParameterSpec class name>, <parameters
* for constructing an AlgrithomParameterSpec object>]]]];
+ * }
*
* @author Sharon Liu
*
http://hg.openjdk.java.net/jdk9/dev/jdk/file/6dea581453d7/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java#l49
Has open < and > characters, for normal doc production this is not an issue as this class in package private,
however for folks trying to build with -package or -private javadoc options, this issue will likely to cause issues.
The fix is simple either replace those characters with HTML entities
or surround that example snippet with {@code ......}
A possible patch
diff --git a/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java b/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java
--- a/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java
+++ b/src/java.base/share/classes/javax/crypto/CryptoPolicyParser.java
@@ -46,10 +46,12 @@
*
* The format of a permission entry in the jurisdiction policy file is:
*
+ * {@code
* permission <crypto permission class name>[, <algorithm name>
* [[, <exemption mechanism name>][, <maxKeySize>
* [, <AlgrithomParameterSpec class name>, <parameters
* for constructing an AlgrithomParameterSpec object>]]]];
+ * }
*
* @author Sharon Liu
*
- backported by
-
JDK-8180238 CryptoPolicyParser's API comment contains < and > characters
-
- Resolved
-
- relates to
-
JDK-8176901 Internal error running javadoc over jdk internal classes
-
- Closed
-