RFR: 8278254: Cleanup doclint warnings in java.desktop module [v4]
Prasanta Sadhukhan
psadhukhan at openjdk.java.net
Mon Jan 24 11:31:11 UTC 2022
On Mon, 24 Jan 2022 10:51:00 GMT, Alexey Ivanov <aivanov at openjdk.org> wrote:
>> It is already mentioned in getSystemDisplayName, getSystemTypeDescription, getSystemIcon, isRoot. Anyways, I have removed the linkage for the new addition as it will not be able to resolve.
>
> If `ShellFolder` remains mentioned, I'd rather use `<code>ShellFolder</code>` as it was done originally.
>
> I guess Sergey challenged the fact of referencing `ShellFolder`. The fact that it could be `ShellFolder` rather than `File` is an implementation detail. Can we drop that from the spec?
>
> On the other hand, `ShellFolder` class, even though it's not a public API, is mentioned in quite a few methods in `FileSystemView`.
>
> I don't have a strong opinion here. Perhaps, we should scrap all the references to `ShellFolder`.
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.
-------------
PR: https://git.openjdk.java.net/jdk/pull/7004
More information about the client-libs-dev
mailing list