javac reports broken HTML on multiline mailto links

[Uwe Schindler]

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
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/javadoc-dev/attachments/20201223/fde83891/attachment.htm>