Re: Review of current draft
Peter McGoron 22 May 2026 22:00 UTC
Thank you for the comments. I will incorporate the suggestions. Below
are comments about specific points:
_______________________________________________________________
On 5/22/26 16:56, Wolfgang Corcoran-Mathe wrote:
> 3. Rationale: What's this sentence doing here? "C, Julia, Java, and Zig
> allow one to write floating point numbers using IEEE 754-2008's syntax
> (which was derived from C99)."
That is intended to justify adding this syntax by pointing out that
other languages have similar syntax. I can reword that.
> 5. Spec: "Non-normative text is in small text." I'd prefer "small
print". More importantly, small print is an accessibility problem. Give
the people using screen readers some additional indicator of
non-normative content.
I am using the HTML element <small> to mark up non-normative comments.
"Side comments" is the semantics of that element per the HTML living
standard. I can add a "Note: " to such sections to indicate that it is a
note and not a part of the spec.
> 6a. Spec: It's not clear from the grammars alone that the #x prefix
is a required part of the syntax.
It is because ⟨ureal 16⟩ can only be produced (in the strict Scheme
grammar) when ⟨prefix 16⟩ ::= #x is present. I will note that.
-- Peter McGoron