javac reports broken HTML on multiline mailto links

Jonathan Gibbons jonathan.gibbons at oracle.com
Wed Dec 23 19:32:10 UTC 2020


I'll open a bug later today, if you don't do it first. Mostly, it's just 
a matter of who gets to be recorded as the "reporter"

-- Jon

On 12/23/20 10:38 AM, Uwe Schindler wrote:
> I may open a bug on behalf of Dawid and Apache Lucene, if you haven't 
> done already.
>
> Uwe
>
> Am December 23, 2020 5:47:41 PM UTC schrieb Jonathan Gibbons 
> <jonathan.gibbons at oracle.com>:
>
>     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
>         <https://gist.github.com/dweiss/c1c9f218c6a8e5d2f253193806a9f472> 
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20201223/39a08b4e/attachment.htm>


More information about the javadoc-dev mailing list