non-normative information is italicized, not indented

[Gavin Bierman]

Hi Felix,

Thanks for your email and interest in the JLS!

Indeed, the formatting of the HTML and PDF versions of the specs are not aligned as they should be - you’re quite right. I had a go at sorting this out, but I had to revert as they revealed more deep-seated formatting and productions issues that I couldn’t quite sort out in time for JDK 25. So, you’ll have to endure the inconsistency for the next edition. Fingers crossed that I can figure out the fixes for JDK 26 :-)

Many thanks again,
Gavin

On 10 Dec 2022, at 14:15, Felix Pahl <joriki27 at gmail.com> wrote:

Referring to this version of the JLS: https://docs.oracle.com/javase/specs/jls/se11/html/jls-1.html#jls-1.3 :

Section 1.3 ("Notation") says that "non-normative information [...] is given in smaller, indented text."

It's not actually indented (neither in the example given there, nor when this convention is used in the specification) but italicized.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.org/pipermail/jls-jvms-spec-comments/attachments/20250730/338a6347/attachment.htm>