[r6rs-discuss] [Formal] Bytevectors: Sections 2.5 and 2.6 are inappropriately structured.

[Ludovic Courtès]

---
This message is a formal comment which was submitted to formal-comment at r6rs.org, following the requirements described at: http://www.r6rs.org/process.html
---
Submitter:      Ludovic Courtès
Email:          ludovic.courtes at laas.fr
Type of Issue:  Defect
Priority:       Minor
Component:      Bytevectors
Report:         Revised^5.92 Report on the Algorithmic Language Scheme,
                Standard Libraries
Summary:        Sections 2.5 and 2.6 are inappropriately structured.


Section 2.5 of the report (page 8) is entitled "Operations on 32-bit
integers" but contains operations on 32-bit and 64-bit integers, as well
as operations on IEEE-754 simple-precision floating point numbers.
Section 2.6 contains the remaining operations on IEEE-754 numbers, but
operations on simple-precision and double-precision numbers are
interleaved, which makes the section hard to follow.

I would suggest creating a section "Operations on 64-bit integers"
containing the relevant operations, followed by a section entitled
"Operations on IEEE-754 floating-point numbers" containing all the
IEEE-754-related procedures, starting with simple-precision and going on
with double-precision.

Thanks,
Ludovic.