javac reports broken HTML on multiline mailto links

Jonathan Gibbons jonathan.gibbons at oracle.com
Wed Dec 23 17:47:41 UTC 2020


Wow. And Merry Christmas to you too.

I confirm your results for all your files.

Further experimentation reveals it is strongly related to the `@` 
character in the mailto: link.  Change that character in `Breaks.java` 
and it passes.

Do you want to file the bug, or would you like me to?

-- Jon

On 12/23/20 2:39 AM, Dawid Weiss wrote:
> 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


More information about the javadoc-dev mailing list