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

javac/doclint reports broken HTML on multiline mailto links

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Resolved
    • Priority: P3
    • Resolution: Fixed
    • Affects Version/s: 15
    • Fix Version/s: 16
    • Component/s: tools
    • Labels:
    • Subcomponent:
    • Resolved In Build:
      b31

      Backports

        Description

        From javadoc-dev:

        Hello and Merry Christmas,

        I discovered this odd javac behavior with jdk8 up to jdk15 (didn't
        check the latest head). This source file (note the anchor tag over
        multiple lines):

        /**
         * Lucene internals or asking for help on <a
         * href="mailto:java-user at lucene.apache.org">java-user at lucene.apache.org</a>
          */
        public class Breaks {}

        When compiled with

        javac -Xdoclint:all/protected Breaks.java

        generates this:

        Breaks.java:2: error: malformed HTML
         * Lucene internals or asking for help on <a
                                                  ^
        Breaks.java:3: error: bad use of '>'
         * href="mailto:java-user at lucene.apache.org">java-user at lucene.apache.org</a>
                                                    ^
        Breaks.java:3: error: unexpected end tag: </a>
         * href="mailto:java-user at lucene.apache.org">java-user at lucene.apache.org</a>
                                                                                ^
        What's interesting is that the following two alternatives compile just fine:

        /**
         * Lucene internals or asking for help on <a
         * href="http://lucene.apache.org">java-user at lucene.apache.org</a>
          */
        public class Passes {}

        /**
         * Lucene internals or asking for help on <a
        href="mailto:java-user at lucene.apache.org">java-user at lucene.apache.org</a>
        to figure out why.
          */
        public class Passes2 {}

        Is it just me or all these should compile just fine?...

        Dawid

        [1] Just in case mail clients attempt to reformat the pasted examples,
        here's a gist with
        the sources:
        https://gist.github.com/dweiss/c1c9f218c6a8e5d2f253193806a9f472

          Attachments

            Issue Links

              Activity

                People

                Assignee:
                jjg Jonathan Gibbons
                Reporter:
                jjg Jonathan Gibbons
                Votes:
                0 Vote for this issue
                Watchers:
                4 Start watching this issue

                  Dates

                  Created:
                  Updated:
                  Resolved: