<i18n dev> RFR: 8278254: Cleanup doclint warnings in java.desktop module [v4]

Alexey Ivanov aivanov at openjdk.java.net
Mon Jan 24 11:39:12 UTC 2022


On Mon, 24 Jan 2022 11:34:04 GMT, Alexey Ivanov <aivanov at openjdk.org> wrote:

>> Since it is mentioned in other places, I would rather not scrap it. Also, since in most places it is mentioned as a non-link value, I chose to modify it.
>
> The `<code>` element does not create a link, it uses monospace font to render its contents which implies it's part of computer code. Class names usually marked up with `<code>` HTML element or with `{@code }` javadoc element.
> 
> These aren't used consistently. Often classes aren't marked up. So you're right: in the majority of cases, `ShellFolder` isn't marked up. The `<code>` markup is used in two methods only: `isRoot` and `getChild`.

I was referring to removing all the references to `ShellFolder` from public API, under another bugid, if it's to be done.

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

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


More information about the i18n-dev mailing list