JEP 467 - leading and trailing code blocks by indentation

Jonathan Gibbons jonathan.gibbons at oracle.com
Fri Aug 16 18:59:20 UTC 2024


Filed

 1. JDK-8338525 <https://bugs.openjdk.org/browse/JDK-8338525>

-- Jon

On 8/15/24 4:20 PM, Michel Trudeau wrote:
>
> Please file a bug.   We’ll investigate.
>
> *From: *javadoc-dev <javadoc-dev-retn at openjdk.org> on behalf of 
> Stephan Herrmann <stephan.herrmann at berlin.de>
> *Date: *Wednesday, August 14, 2024 at 5:14 PM
> *To: *javadoc-dev at openjdk.org <javadoc-dev at openjdk.org>
> *Subject: *JEP 467 - leading and trailing code blocks by indentation
>
> Hi,
>
> Using javadoc 23-ea the following snippet is not handled the way I would
> expect from the specification in JEP 467:
>
>      ///     @Override
>      ///     void m() {}
>      ///
>      /// Plain text
>      ///
>      ///     @Override
>      ///     void m() {}
>      public void m() {}
>
> First, javadoc complains on the first line that @Override is an unknown
> tag. But due to the indentation it should be parsed as code, not as a
> javadoc tag.
>
> Second, when I remove the offending line (or move it down one line),
> then the first code block is correctly rendered, but the second,
> trailing code block is silently dropped.
>
> best,
> Stephan
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/javadoc-dev/attachments/20240816/7e3f33cf/attachment.htm>


More information about the javadoc-dev mailing list