The structure of Chapter 4 (names and the sequence numbers of paragraphs). Small "Java Language Specification" improvement.

[Dmitri Cerkas]

Hello JLS Team,

here I would want to do some observations about "Chapter 4" generic structure (and especially to names and the sequence numbers of paragraphs).
If you look at "Table of Contents" you can see the following substructure in "Chapter 4":
"4.3 Reference Types and Values 52 4.3.1 Objects 53 4.3.2 The Class Object 56 4.3.3 The Class String 56 4.3.4 When Reference Types Are the Same 574.4 Type Variables 57"
In the paragraph "4.3. Reference Types and Values." you:   1) lists all kinds of reference types (class, interface, type variable, and array)   2) describe classes and interfaces reference types
In the subparagraph "4.3.1 Objects" you explain what is the reference value.Then subparagraphs "4.3.2" and "4.3.3" explain two important elements of reference types - classes "Object" and "String".
"4.4 Type Variables" is another one paragraph that tells about the one the of four reference types.
So, taking into account said above, my suggestions about the names are:1) because "4.3. Reference Types and Values." is about reference Types and Values, i think that "4.3.1" should be: "4.3.1  Objects and Reference values"2) because type variables are the one of the four kinds of reference type, "4.4 Type Variables" should be included in "4.3." as subparagraph, so it become: "4.3.5    Type Variables".
Finalizing...  In the "Table of Contents", "Chapter 4" should have the following substructure:"4.3 Reference Types and Values 52 4.3.1 Objects and Reference Values 53 4.3.2 The Class Object 56 4.3.3 The Class String 56 4.3.4 When Reference Types Are the Same 57        4.3.5 Type Variables 57"
Thank you very much and sorry for disturbing!Have a nice day,Dmitri.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/jls-jvms-spec-comments/attachments/20220620/30dfde70/attachment.htm>