RFR: 8309819: Clarify API note in Class::getName and MethodType::toMethodDescriptorString [v6]

[Chen Liang]

On Mon, 26 Jun 2023 22:33:35 GMT, Mandy Chung <mchung at openjdk.org> wrote:

>> "component descriptor" tried to refer to both parameter types and return type descriptors. How about "produce identical class descriptors in method descriptors?"
>
> `MethodType::descriptorString` refers to method descriptor and `Class::descriptorString` refers to class descriptor.   I don't think it helps to say "produce identical class descriptors in method descriptors".

I think we can put it simple:
"Two distinct classes which share a common name but have different class loaders cannot be distinguished in descriptor strings"
which stands for both class and method descriptors. How does this sound?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/14411#discussion_r1242883757