RFR: 8300011: Refactor code examples to use @snippet in java.util.TimeZone [v3]

Lance Andersen lancea at openjdk.org
Fri Jan 13 11:10:15 UTC 2023


On Thu, 12 Jan 2023 22:21:39 GMT, Justin Lu <duke at 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.
>
> Justin Lu has updated the pull request incrementally with one additional commit since the last revision:
> 
>   Re-add blockquotes (indendation)

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

> 317:      * getDisplayName(false, LONG,
> 318:      *                // @link substring="Locale.Category.DISPLAY" target="Locale.Category#DISPLAY" :
> 319:      *                Locale.getDefault(Locale.Category.DISPLAY))

One thought here as I look at this again and now that this is a snippet is that we should probably add the trailing `;` to the code examples...

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

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


More information about the core-libs-dev mailing list