On Tue, 19 Oct 2021 23:37:17 GMT, Jonathan Gibbons <[email protected]> wrote:
>> Please review this simple change to add doc comments to the so far
>> undocumented `HtmlStyle` constants. I also removed one more unused constant
>> (memberNameLabel).
>
> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/markup/HtmlStyle.java
> line 836:
>
>> 834:
>> 835: /**
>> 836: * The class af a {@code div} element containing a text block that
>> is part of a
>
> `s/af/of/`
>
> `text block` sounds too much like the Java construct. Is there a better way
> to phrase this? Do you need the word "text" at all?
Agreed. I think "part(s) of documentation comment(s)" is a better choice. Let
me know if you have another suggestion.
-------------
PR: https://git.openjdk.java.net/jdk/pull/5944