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