Integrated: 8277026: Remove blank lines remaining from snippet markup

Pavel Rappo prappo at openjdk.java.net
Wed Dec 1 01:28:29 UTC 2021


On Tue, 30 Nov 2021 19:47:35 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

> This PR proposes to omit lines from the snippet source if those lines consist only of markup and perhaps whitespace. For example, if this PR is integrated, these three snippets will result in the same output:
> 
>     // @start region="example1"
>     if (v.isPresent()) {
>         System.out.println("v: " + v.get());
>     } // @end
> 
> 
>     if (v.isPresent()) { // @start region="example2"
>         System.out.println("v: " + v.get());
>     } // @end
> 
> 
>     // @start region="example3" :
>     if (v.isPresent()) {
>         System.out.println("v: " + v.get());
>     // @end :
>     }
> 
> While this change complicates the mental model for markup, it removes otherwise unavoidable inner blank lines in properties files, for example:
> 
>     coffee=espresso
>     # @highlight:
>     tea=ice

This pull request has now been integrated.

Changeset: da2be99c
Author:    Pavel Rappo <prappo at openjdk.org>
URL:       https://git.openjdk.java.net/jdk/commit/da2be99cfe1121d5a59fa575ea0ac425ad4dbd0f
Stats:     251 lines in 7 files changed: 240 ins; 2 del; 9 mod

8277026: Remove blank lines remaining from snippet markup

Reviewed-by: jjg

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

PR: https://git.openjdk.java.net/jdk/pull/6623


More information about the javadoc-dev mailing list