Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8178014

CryptoPolicyParser's API comment contains < and > characters

XMLWordPrintable

    • b169
    • generic
    • generic
    • Not verified

        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
          *

              wetmore Bradford Wetmore
              ksrini Kumar Srinivasan
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

                Created:
                Updated:
                Resolved: