RFR: 8283269: Improve definition and use of jdk.javadoc.internal.doclets.toolkit.Content

[Jonathan Gibbons]

On Wed, 23 Mar 2022 10:49:24 GMT, Pavel Rappo <prappo at openjdk.org> wrote:

>> Does your comment mean that we should similarly refine (later) the term "Inheritance Tree"?
>> 
>> To make sure we're on the same page, that method (whose doc comment we are talking about) is in charge of producing a small tree-like diagram you can see on the top of a class page. For example, for java.util.ArrayList that diagram looks like this:
>> 
>> 
>> java.lang.Object
>>     java.util.AbstractCollection<E>
>>         java.util.AbstractList<E>
>>             java.util.ArrayList<E>
>
> Is there a suitable term we could use to describe this _ancestry_ information? We are specifically interested in a superclass-subclass chain that connects a class in question with java.lang.Object.

`class hierarchy` ?
`superclass chain` ?
`superclasses` ?
`inheritance chain` ?
`list of superclasses` ?
`ancestors` ?
`inheritance list` ?
`superclass list` ?



'inheritance` isn't a bad word, it just doesn't work as a noun in this context. The problem is using it with `tree`, since the superclass-subclass chain is a degenerate tree that is a list.

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

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