[r6rs-discuss] [Formal] Integer division examples should be written in Scheme.

From: Aubrey Jaffer <agj>
Date: Fri, 22 Jun 2007 17:46:17 -0400 (EDT)

---
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's name: Aubrey Jaffer
	submitter's email address: agj at alum.mit.edu
		    type of issue: Defect
		         priority: Minor
		   R6RS component: 9.8.3 Semantics of common operations
	    version of the report: 5.94
one-sentence summary of the issue: 
Integer division examples should be written in Scheme.
    full description of the issue:
Section 9.8 Generic arithmetic discusses both Scheme and mathematics.
In order to prevent confusion about context, mathematical formulas
should be written using conventional (infix) mathematical notation,
while Scheme expressions should be written using Scheme notation.
But the examples of Scheme functions in "Integer division" are not
written in Scheme:
   123 div 10  =  12
   123 mod 10  =  3
   ...
Scheme calls in sections labeled "Examples" should be written in
Scheme:
   (div 123 10)   ==> 12
   (mod 123 10)   ==> 3
   ...
If an editor finds Scheme syntax too ugly to use, then that editor is
working on the wrong project!
Received on Fri Jun 22 2007 - 17:46:17 UTC

This archive was generated by hypermail 2.3.0 : Wed Oct 23 2024 - 09:15:01 UTC