Re: [Scheme-reports] organizational comment regarding modules John Cowan (19 May 2011 17:40 UTC)

Re: [Scheme-reports] organizational comment regarding modules John Cowan 19 May 2011 17:39 UTC

Andy Wingo scripsit:

> I find it a bit jarring to see "delay" so far away from "force".  Now
> that we have modules, why not reorganize things a little bit?  It's
> probably OK to have syntax not all in one section.
>
> I also think that the notation "FOO module procedure" is a bit too
> understated, and would benefit from modules being documented in their
> own sections.

The WG consensus was to keep the R5RS structure as much as possible,
since many people have internalized it.  When using an R7RS
implementation casually, the expectation is that you don't much have to
care what module an identifier is in: only when writing a module do you
need to be careful.

For the most part the WG1 modules reflect the optionality historically
present in pre-R6RS versions of Scheme: for example, the inexact module
provides procedures which are not required if you don't have inexact
numbers, and the complex module ditto for general complex numbers.
Conceptually, however, they are integrated with the rest of the numeric
procedures, and it's not that helpful to explain them in a wholly
disjoint part of the report.  Likewise, the procedures in the unicode
module are those which depend on casing and normalization tables.
(I've filed tickets to split it into two modules named casing and
normalization.)

--
De plichten van een docent zijn divers,         John Cowan
die van het gehoor ook.                         cowan@ccil.org
      --Edsger Dijkstra                         http://www.ccil.org/~cowan

_______________________________________________
Scheme-reports mailing list
Scheme-reports@scheme-reports.org
http://lists.scheme-reports.org/cgi-bin/mailman/listinfo/scheme-reports