On Wed, 11 Jan 2023 23:41:46 GMT, Justin Lu <d...@openjdk.org> wrote:

> This PR implements JEP 413: Code Snippets in Java API Documentation for 
> _[java.util.TimeZone](https://docs.oracle.com/en/java/javase/19/docs/api/java.base/java/util/TimeZone.html)_.
> 
> Code examples using <pre> ...  </pre> blocks are replaced with the @ snippet 
> syntax where applicable.

src/java.base/share/classes/java/util/TimeZone.java line 313:

> 311:      * <p>This method is equivalent to:
> 312:      * {@snippet lang=java :
> 313:      * getDisplayName(false, LONG, // @link substring="LONG" 
> target="#LONG"

You could move those `@link` directives above the code and concatenate them 
with ":", e.g,

    * // @link substring="LONG" target="#LONG" :
    * getDisplayName(false, LONG,

so that the line won't be very long.

-------------

PR: https://git.openjdk.org/jdk/pull/11955

Reply via email to