Feedback for The Java® Language Specification

Sergiusz Wolicki sergiusz at wolicki.com
Tue Jun 24 23:08:35 UTC 2025


Dear Colleagues,

Section 2.4 of the Java Language specification
<https://docs.oracle.com/javase/specs/jls/se24/html/jls-2.html> describes
the notation used to present the grammar of the language. It advises that
terminal symbols are shows in a fixed width non-italic font. However, the
examples in the section do not visually differentiate between terminals and
non-terminals, at least not to me. I have looked at the page in Firefox,
Edge, and Chrome. The terminals "if", "break", parentheses, and semicolon
look the same as non-terminal. They look italic to me. This problem makes
the section pretty confusing. Here are two screenshots from two browsers:

[image: obraz.png]

[image: obraz.png]

Interestingly, the actual grammar snippets in later chapters of the
specification look correct.


Thanks and best regards,
Sergiusz Wolicki
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/jls-jvms-spec-comments/attachments/20250625/96d88bbc/attachment-0001.htm>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: obraz.png
Type: image/png
Size: 13086 bytes
Desc: not available
URL: <https://mail.openjdk.org/pipermail/jls-jvms-spec-comments/attachments/20250625/96d88bbc/obraz-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: obraz.png
Type: image/png
Size: 26915 bytes
Desc: not available
URL: <https://mail.openjdk.org/pipermail/jls-jvms-spec-comments/attachments/20250625/96d88bbc/obraz-0003.png>


More information about the jls-jvms-spec-comments mailing list