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

java.smartcardio has broken docs for exceptions

XMLWordPrintable

    • b18
    • generic, other
    • Not verified

      In the doc comment for CardException and CardNotPresentException, the first sentence of one of the constructors is rendered incorrectly, because of a bad interaction with the doclet's determination of the first sentence.

      Specifically, the following comment:
           * Constructs a new CardNotPresentException with the specified cause and a detail message
           * of <code>(cause==null ? null : cause.toString())</code>.
      causes the first sentence to end prematurely at the "?", which is bad in and of itself, but also causes the generated HTML to be broken because of the unbalanced <code> that appears in theose contents where just the first sentence appears.

            jjg Jonathan Gibbons
            jjg Jonathan Gibbons
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved: