This site is a static rendering of the Trac instance that was used by R7RS-WG1 for its work on R7RS-small (PDF), which was ratified in 2013. For more information, see Home.

Source for wiki WG1BallotCowan version 44

author

cowan

comment


    

ipnr

198.185.18.207

name

WG1BallotCowan

readonly

0

text

= Instructions =

    * You may list as many of the options as you want in order of preference.
    * Options are comma-delimited (ignoring space) and case-insensitive.
    * You can pipe-delimit (|) options you want to give equal weight to.
    * You may write in your own option if you announce it to the list first.
    * You may specify a variant with option/variant, for example srfi-1/module to vote for srfi-1 but clarify it should be in a separate module. Please also include the srfi-1 option in this case.
    * You can write a free-form rationale after the "preferences" line,
    * module means "yes, but I want it in a separate module",
    * wg2 means "no, but I think it should go in WG2".
    * undecided means I want to discuss this issue further.
    * Abstain on any item by leaving the preferences blank. 

= WG1 Ballot Items To Finalize By July 31 =

== WG1 - Core ==

=== #460 Semantics of `eqv?` ===

Earlier we voted on #125, #229 and #345 separately without regard to
the formal semantics of `eqv?` from a top level.  We need to first
decide what the definition of `eqv?` is, and consider if there should
be any exception cases as a secondary effect.

The debate is fundamentally one of whether we define `eqv?` in terms
of "operational equivalence" as in R6RS or a simpler rule
(e.g. resolve by `=`) as in earlier standards.

R2RS had the simplest historical rule which was simply to use `=`.

The term "operational equivalence" appears in R3RS but for numbers the
definition is the same as in R4RS and R5RS, which is `=` plus the same
exactness.  This is the `r5rs` option.

R6RS defines two numbers to be "operationally equivalent" (and
therefore `eqv?`) if they would return the same results for any finite
composition of "Scheme's standard arithmetic procedures".  Presumably
this refers to everything in section 11.7 "Arithmetic", but not, for
example, `write`.  For R7RS this would be equivalent to all the
standard procedures in the "Numbers" section 6.2.6, and is called the
`r6rs` option.  Alternately, the equivalence rules could include any
procedure the implementation provides (such as `decode-float`) - this
is the `r6rs/all` option.  Operational equivalence is very desirable
when implementing caches and programs which reason about programs.

In contrast to R6RS, R7RS does not require the full numeric tower.
This means that any definition of operational equivalence would render
many numbers unspecified from the perspective of the standard, yet
users could rely on consistency within their own implementation, and
broad agreement amongst most implementations which provide the full
tower.  For example, `(eqv? 1/3 (/ 3.0))` is unspecified under any
definition, because exact ratios may not be supported.  However,
`(eqv? 0.0 -0.0)` is specified and required to return `#t` under the
`r5rs` rule, yet is unspecified under the `r6rs` rule - it would
return `#f` for implementations which distinguish both `-0.0` and
`-inf.0` (without which `-0.0` does not produce different results from
`0.0`) and `#t otherwise`.  Under `r6rs/all`, `(eqv? 0.0 -0.0)` should
return `#f` under any implementation which would at least write `-0.0`
with the leading minus sign.  Any notation using precision specifiers
would also has undefined equivalence under the `r6rs` rule, e.g.
`(eqv? 1e0 1f0)`.

Keep in mind the semantics of `eqv?` also affect `memv`, `assv` and
`case`.

  * '''References:'''
    * [https://groups.google.com/d/msg/scheme-reports-wg1/BGvDFtD6A1M/5pHmfXHtvEIJ eqv? issues summarized]
    * [https://groups.google.com/d/msg/scheme-reports-wg1/2Nv6oIND8HI/Z2HXPQMNFooJ the history of eqv? on numbers]
  * '''Options:''' r5rs, r6rs, r6rs/all
  * '''Default:''' r5rs
  * '''Preferences:''' undecided

=== #229 eqv? and NaN ===

As announced previously this is being re-opened due to incorrect
formulation in the previous ballot, and in response to formal comment
#423.

Regardless of the result of #460, the semantics implies that `eqv?`
return `#f` on comparing any two NaN objects.  It is reasonable to
want to consider any two NaNs as the "same" since they behave the same
under any operation, even though none of the results are `=`.  In
deference to this R6RS makes an exception and allows the result to be
unspecified, and we should consider allowing this exception.

The "same" options from previous ballots have been removed, pending an
alternate formulation of the semantics of #460 in which this would
make sense.

The default of `unspecified` still holds from the previous invalidated
ballot.

  * '''Options:''' different, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' undecided

=== #125 Allow procedures not to be locations (making EQV? unspecified in some additional cases) ===

Procedures are another case for contention with `eqv?`.  In R3RS, an
operational equivalence was defined for procedures, and this was
subsequently removed.

R6RS went the other direction and allowed the exact same procedure `x`
to return `#f` for `(eqv? x x)`, and R7RS currently reaffirms this.
The rationale behind this is for compiler optimizations such as
inlining local procedures, that is given:

{{{
(let ((square (lambda (x) (* x x))))
  (eqv? square square))
}}}

it is reasonable for a compiler to perform the optimization:

{{{
(eqv? (lambda (x) (* x x)) (lambda (x) (* x x)))
}}}

in which case the result would naturally return `#f`.

Vote `yes` to allow the result to be `#f`.

The default of `yes` still holds from the previous invalidated ballot.

  * '''Options:''' yes, no, undecided
  * '''Default:''' yes
  * '''Preferences:''' undecided

=== #393 Defining record equality ===

Currently, R7RS-small says that when `equal?` is applied to records
that are not `eqv?` (that were constructed by different calls to the
record constructor), the result may be `#t` or `#f` at the
implementation's discretion.  The proposal is to treat records of the same
type like pairs, strings, vectors, and bytevectors: that is, their
contents are recursively compared.

Vote `recursive` to require recursive comparison of the record's
fields, `identity` to return `#t` iff `eqv?` does, and `unspecified`
to leave this open.

Note `equal?` is already required to handle cycles regardless.

  * '''Options:''' recursive, identity, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' unspecified
  * '''Rationale:''' Existing systems shouldn't have to change their `equal?` to conform to R7RS.

=== #306 What does "full Unicode" support mean in Appendix B? ===

Specifically, does it indicate case-folding and normalization support
for the repertoire of any particular version of Unicode, or any
version greater than 5 or 6 or 6.1, or no particular version?

Full unicode refers to the set of characters available.  Case-folding
and character predicates are required to work according to the Unicode
standard for all supported characters.  The question of which version
of Unicode the property refers to is important.  We could require a
specific version (and all further revisions), or always require the
latest official Unicode standard, in which case an implementation
would not be compliant until it was updated with each new standard.

  * '''Options:''' at-least-6, at-least-6.1, latest, undecided, unspecified
  * '''Default:''' unspecified
  * '''Preferences:''' undecided

=== #458 Remove the formal semantics from the report ===

There have been a bunch of complaints about the formal semantics: it's
incomplete, it cannot be mechanized with a proof assistant, it doesn't
help either users or implementers very much, and so on.  See in
particular #453.

The semantics have been updated to include `dynamic-wind`, however the
other arguments still hold.

This proposal is to remove it from the report altogether, and to urge
the Steering Committee to create a new WG to produce one, likely in a
"rolling" style with increasingly comprehensive releases, on its own
schedule.  Some members of the current WG have expressed interest in
serving on such a group, and others have expressed their complete lack
of interest, so a new WG seems the best choice if this is done.

Alternately, we can adapt the operational semantics from R6RS.

  * '''Options:''' remove, keep, operational, undecided
  * '''Default:''' keep
  * '''Preferences:''' remove
  * '''Rationale:'''  The formal semantics broken as written, and even if we patched it up, it would still be less than helpful.  We need to let a separate group do a better job.

=== #398 Allow repeated keys in `case` ===

R5RS says it's an error for a key to appear in more than one clause of
`case` (or twice in the same clause, but that's trivial).  R6RS allows
the same key to appear more than one clause, but insists on
left-to-right testing throughout, like `cond`.  The R6RS editors
thought this was better for machine-generated code, though worse for
hand-written code.

The proposal is a compromise: allow keys to appear in more than one clause,
but behave as if the key appeared only in the first (leftmost) clause.
This allows hash-table or other non-left-to-right implementations.

  * '''Options:''' r5rs, r6rs, leftmost, unspecified, undecided
  * '''Default:''' r5rs
  * '''Preferences:''' leftmost
  * '''Rationale:'''  `Leftmost` is a reasonable compromise between R5RS and R6RS; the latter overspecifies the mechanism.

=== #85 Blobs, bytevectors, byte-vectors, octet-vectors, or something else?

Following exactly in the footsteps of R6RS we voted for a `blob` API
and then changed the name to `bytevector`.

Formal comment #435 argues that `u8vector` is in more common use, so
this item is being re-opened.  The default is the current draft
`bytevector`, and for any member leaving the preferences are left
blank their votes from ballot 3 will be used.

  * '''Options:''' blob, bytevector, byte-vector, u8vector, octet-vector, undecided
  * '''Default:''' bytevector
  * '''Preferences:''' blob
  * '''Rationale:'''  Neither `bytevector` nor `u8vector` fully captures the idea here, which is of a collection of unstructured binary information.  `Blob` does that nicely.

== WG1 - Library System ==

=== #353 No use before import in libraries ===

For ease of implementation, the proposal is to make it an error for an
imported identifier to be referenced or defined in a library before
the library declaration that imports it.  This allows strict
left-to-right processing of library declarations, with no need to
delay processing till the end of the library.

Therefore, this would be an error (but still permitted as an extension
in Schemes that can easily provide it):

{{{
(module
  (begin (define x y))
  (import (library defining y))
}}}

This would necessitate replacing the penultimate paragraph of section
5.5.1 with:

One possible implementation of libraries is as follows: After all
`cond-expand` library declarations are expanded, a new environment is
constructed for the library consisting of all imported bindings. The
expressions and declarations from all `begin`, `include`, and
`include-ci` declarations are expanded in that environment in the
order in which they occur in the library declaration.  Alternatively,
`cond-expand` and `import` declarations may be processed in left to
right order interspersed with the processing of expressions and
declarations, with the environment growing as imported bindings are
added to it by each `import` declaration.

Vote `yes` to add the restriction, or `no` to leave it out.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  This is how Chicken works, and I think left-to-right processing is a Good Thing whenever possible.  Note that this has nothing to do with the fact that the library form is read all at once, and everything to do with how it is processed.

=== #359 Limit numbers used in library names ===

This is a proposal to limit numbers in library names to the range 0 to
32767.  Currently, there is no portable lower bound which all Schemes
can assume as the maximum size of an integer.

Numbers are mostly used for SRFI-based libraries anyway, which are not
likely to reach either limit.

The option `uint15` for the proposal as stated (0 to 32767), `int16`
for -32768 to 32767, int24 for -2^23^ to 2^23^-1, etc.

Vote `unspecified` to make no explicit requirement on the integers
allowed in library names.

  * '''Options:''' uint15, int16, uint16, int24, uint24, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' uint15
  * '''Rationale:'''  I may change this later when/if Alex explains why negative numbers are useful in library names.  We haven't had them up to now.

=== #441 Make sure a program/library loads any imported libraries at most once ===

Add the following text to the discussion of library loading:

 Regardless of the number of times that a library is loaded, each
 program or library that imports bindings from a library will receive
 bindings from a single loading of that library, regardless of the
 number of `import` or `cond-expand` declarations in which it appears.

to make it clear that, for example,

{{{
(import (prefix (foo) 'foo:))
(import (only (foo) bar))
}}}

will cause `bar` and `foo:bar` to come from the same instantiation of
the library '(foo)'

Vote `yes` to add this requirement.

  * '''Options:''' yes, no, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' yes
  * '''Rationale:'''  This is not a case R6RS deals with, but I think it's sensible to require all imports from the foo library into the bar library to come from the same instantiation.

=== #402 Add an export-all form. ===

Add an export-all form to the library declaration that means "export
all identifiers that are defined in the library with begin, include,
and include-ci but none that are imported with import."

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  I think this is very useful for reducing bureaucracy in small libraries.  Chicken has it.

=== #448 Add library declaration include-library-declarations ===

The proposed `include-library-declarations` allows a library to
incorporate a file containing arbitrary library declarations, not just
Scheme code (definitions and expressions).  This allows, for example,
the exports of a module to be written directly in the library file,
and its imports in a separate file.

An alternative would be something like `(export-from <library>)` to
export the same bindings as another library.  This does require the
clumsiness of actually defining the identifiers in the other library
if it is abstract.

  * '''Options:''' include-library-declarations, export-from, no, undecided
  * '''Default:''' no
  * '''Preferences:''' include-library-declarations
  * '''Rationale:'''  Though this name is verbose even by Scheme standards, what it provides is very helpful.  In simple implementations, it can be the same as include.

=== #449 Clarify library loading rules ===

R7RS currently says:

 Within a program, each imported library is loaded at least once, and,
 if imported by more than one program or library, may possibly be
 loaded additional times.

Richard Kelsey thinks this is too liberal, and proposes:

 Regardless of the number of times that a library is loaded, each
 program or library that imports bindings from a library will receive
 bindings from a single loading of that library, regardless of the
 number of `import` or `cond-expand` forms in which it appears.

Aaron Hsu, however, thinks this is too restrictive, and proposes
(backed up by actual R6RS implementations):

 If a library's definitions are referenced in the expanded form of a
 program or library body, then that library must be loaded before the
 expanded program or library body is evaluated. This rule applies
 transitively.

 Similarly, during the expansion of a library, if a syntax keyword
 imported from a library is needed to expand the library, then the
 imported library must be visited before the expansion of the
 importing library.

  * '''Proposals:'''
    * '''one:''' Kelsey's proposal
    * '''one-or-more:''' current draft
    * '''zero-or-more:''' Hsu's proposal, R6RS status-quo
    * '''zero-or-one:''' Kelsey's proposal with Hsu's relaxation
  * '''Options:''' one, one-or-more, zero-or-one, zero-or-more
  * '''Default:''' one-or-more
  * '''Preferences:''' zero-or-more
  * '''Rationale:'''  I think we should defer to R6RS-based experience here.

== WG1 - Numerics ==

=== #366 Add (log z b) for logarithm of z to the base b ===

Coverage for this R6RS feature is currently sparse: only Gauche, Chez,
Vicare, Larceny, Ypsilon, Mosh, !IronScheme, KSi, RScheme, Rep support
it.  But it is convenient when working in bases other than ''e'' such
as 10, 2, or 16, and it is just a few extra lines of code, since `(log
z b)` => `(/ (log z) (log b))` for arbitrary complex numbers ''z, b''.

Vote `yes` to add the optional second argument from R6RS.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  This is easy for both users and implementers, but implementers should do it once so users don't have to do it more than once (as well as remembering the order of terms in the division!)

=== #367 Inexact division by exact zero ===

Draft 6 says that it's an error for an argument of `/` (other than the
first) to be an exact zero.  R6RS, however, says that it's an error
only if ''all'' the arguments are exact.  In other words, `(/ 2.0 0)`
is an error according to the draft, but in R6RS it returns `+inf.0`
(assuming the implementation supports it).  The proposal is to adopt
the R6RS wording.

Cowan tested `(/ 2.0 0)` in the usual set of Schemes:

 * Racket, Gambit, Chicken (with the numbers egg), Guile, Chibi, Elk, Spark report an error.
 * Gauche, Bigloo, Scheme48/scsh, Kawa, SISC, Chez, SCM, !Ikarus/Vicare, Larceny, Ypsilon, Mosh, !IronScheme, NexJ, STklos, RScheme, BDC, UMB, VX return `+inf.0`.
 * MIT, scsh, Shoe, !TinyScheme, Scheme 7, XLisp, Rep, Schemik, Inlab always report an error when dividing by zero, exact or inexact.
 * KSi, Scheme 9 produce incorrect results.
 * !SigScheme, Dream, Oaklisp, Owl Lisp don't support inexact numbers.

Vote `error` for the current draft semantics that it is an error,
`all-error` for the R6RS semantics that it is only an error if all
arguments are exact, or `unspecified` to make this case unspecified.

  * '''Options:''' error, all-error, unspecified, undecided
  * '''Default:''' error
  * '''Preferences:''' undecided

=== #369 Require that - and / allow an arbitrary number of arguments ===

R5RS requires that `-` and `/` accept one or two arguments, and labels
support for more than two as "optional".  R6RS requires such support.
The proposal is to require it.

All Schemes in the test suite support more than two arguments except
Scheme48/scsh.  (Owl Lisp does not support variadic procedures of any
kind.)

Vote `require` for required n-ary behavior and `optional` to leave it
optional as in R5RS.  Alternately, vote `forbidden` to make this
always an error in all implementations.

  * '''Options:''' required, optional, forbidden, undecided
  * '''Default:''' optional
  * '''Preferences:''' required
  * '''Rationale:'''  It's silly for `(- 1 2 3)` not to Just Work in all Schemes.

=== #370 Log of exact and inexact zero ===

R5RS and draft 6 of R7RS don't say what `(log 0.0)` and `(log 0)`
return.  R6RS requires `-inf.0` and an exception respectively.  The
proposal is to say that `(log 0.0)` returns `-inf.0` on systems that
have `-inf.0`, and that `(log 0)` is an error.

In Racket, Gambit, Chicken (with the numbers egg), Guile, Chibi, Chez,
!Ikarus/Vicare, Larceny, Ypsilon, Mosh, !IronScheme, STklos, Spark,
`(log 0.0)` returns `-inf.0` and `(log 0)` raises an exception.

Gauche, MIT, Chicken (without the numbers egg), Bigloo, Scheme48/scsh,
Kawa, SISC, SCM, NexJ, KSi, RScheme, XLisp, Rep, VX, SXM, Inlab return
`-inf.0` in both cases.

Elk, UMB, Oaklisp raise an exception in both cases.

Scheme 7 returns the wrong answer in both cases.

!SigScheme, Shoe, !TinyScheme, Dream, BDC, Owl Lisp don't support `log`.

Scheme 9 apparently goes into an infinite loop in both cases.

Vote `r6rs` for the R6RS behavior of returning `-inf.0` and raising an
error, respectively.  Vote `infinity` to always return `-inf.0`.

  * '''Options:''' r6rs, infinity, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' r6rs
  * '''Rationale:'''  R6RS got it right here: the limit of log ''x'' as ''x'' -> 0 is negative infinity, which however is not representable within the exact number system.

=== #407 Dividing exact 0 by an inexact number ===

This proposal allows `(/ 0 `''x''`)`, where ''x'' is an inexact
number, to return an exact value.  Currently only Racket, Gambit,
!TinyScheme, Sizzle, Spark do this; see [wiki:Zero Zero] for details.

Vote `zero` to allow (but not require) this to return exact 0.  Vote
`no-nan` to allow it to return 0 except when `x` is `+nan.0`, where it
would return `+nan.0`.

  * '''Options:''' zero, no-nan, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' no-nan
  * '''Rationale:'''  Returning an exact value is good, but propagating NaN is good too.

=== #410 Infinity vs. NaN in max and min ===

Currently R7RS says nothing about the value of `(max +inf.0 +nan.0)`
or `(min -inf.0 +nan.0)`.  R6RS required these functions to return the
infinite value, but this was adopted by some but not all R6RS
implementations (see MaxInfNan for details).  R5RS implementations are
also divided.

The proposal is to allow R7RS implementations to provide either value.

Vote `both` to explicitly add a note that either are allowed,
`infinity` to require the infinite value as in R6RS, `nan` to require
returning `+nan.0`, and `unspecified` leave unspecified (i.e. the same
as `both` but without the note).

  * '''Options:''' both, infinity, nan, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' both, unspecified
  * '''Rationale:'''  If we are going to allow both (as I think we should and must, the arguments on both sides being equally satisfactory), we should say so.

=== #395 Infinite and NaN complex numbers ===

Currently both `infinite?` and `nan?` return `#t` to a complex number
like `+inf.0+nan.0i`.  Is this the Right Thing, or should `infinite?`
only return `#t` if neither part is a NaN?

Note it is reasonable for an implementation to not support partial nan
complex numbers.

Vote `disjoint` to ensure that `infinite?` and `nan?` are disjoint
predicates as in the proposal, or `overlap` to allow the current
behavior.

  * '''Options:''' overlap, disjoint, unspecified, undecided
  * '''Default:''' overlap
  * '''Preferences:''' overlap
  * '''Rationale:'''  I don't really care about the R6RS notion that `finite?`, `infinite?`, and `nan?` form a partition (and in R6RS they don't work on complex numbers anyway).  Testing against the Scheme suite didn't show much, because most Schemes either don't have complex numbers at all, don't have `infinite?` and/or `nan?`, or don't allow complex numbers as arguments to them.  However, Gauche, Chicken with the numbers egg, Vicare, !IronScheme agree that `+inf.0+nan.0i` is both infinite and NaN.  Spark says it is neither, SXM doesn't allow NaN in a complex value.

=== #364 truncate, floor, ceiling round should return a non-finite argument ===

Currently R7RS is silent on what truncate, floor, ceiling, and round
do when the argument is `+inf.0`, `-inf.0`, or `+nan.0`. R6RS has them
return the argument, which seems reasonable.

Tests were made for `(round (* 1.0e200 1.0e200))` on a variety of
implementations.

Racket, Gauche, Chicken (with and without the numbers egg), Bigloo,
Guile, Kawa, Chibi, Chez, SCM, Ikarus/Vicare?, Larceny, Ypsilon, Mosh,
IronScheme, !NexJ, STklos, KSi, Shoe, BDC, Rep, Schemik, Elk, Spark
all return the argument.

MIT, Gambit, Scheme48/scsh, SISC, Scheme 9, Scheme 7, signal errors.

SigScheme, TinyScheme, Dream, UMB don't work for one or another
reason.

Oaklisp and Owl Lisp don't do flonums.

XLisp only has fixnums and flonums, and returns the largest or
smallest fixnum as the case may be.

RScheme returns a variety of slightly strange values: (round +inf.0),
for example, is 0, but (round -inf.0) is -inf.0.

Vote `input` to return the input, `error` to specify "it is an error",
and `unspecified` to leave unspecified as in the current draft.

  * '''Options:''' input, error, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' input, unspecified, error
  * '''Rationale:'''  There's no reason not to go along with R6RS here.

=== #392 Exact positive and non-negative integer predicates ===

There are two useful subsets of the exact numbers, both of which are
commonly called natural numbers, depending on who's talking.
Logicians, set theorists, and computer scientists include 0, other
mathematicians mostly don't.  This proposal adds the predicates
`exact-positive-integer?` and `exact-non-negative-integer?`, analogous
to `exact-integer?`.  Because of the ambiguity, the name
`natural-number?` is not proposed.

Vote `yes` to add these two procedures.

  * '''Options:''' yes, no, wg2, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  Natural numbers are an important type, and Scheme should support it directly.

== WG1 - Read/Write ==

=== #380 Is support of TAB as a whitespace character required or not? ===

2.2 says:

Whitespace characters include the space and newline characters.
(Implementations may provide additional whitespace characters such as
tab or page break.)

However, 7.1.1 has:

<intraline whitespace> -> <space or tab>
<whitespace> -> <intraline whitespace> | <newline> | <return>

So 2.2 implies that supporting tabs is allowed but not required, yet
7.1.1 implies supporting tabs is required.

Vote `required` to require support for tab as a whitespace character
by `read`.  `char-whitespace?` is required to return `#t` for it
regardless.

  * '''Options:''' required, optional, undecided
  * '''Default:''' optional
  * '''Preferences:''' required
  * '''Rationale:'''  All Schemes treat tab as whitespace anyway, though some give it special meaning (completion or whatever) at the REPL.

=== #388 Specify what `display` does with circular lists ===

Currently we don't specify what `display` does with circular lists.
Should it generate labels like `write`, or loop like `write-simple`,
or leave it unspecified?

  * '''Options:''' labels, loop, unspecified
  * '''Default:''' unspecified
  * '''Preferences:''' unspecified
  * '''Rationale:'''  `Display` should be kept as undefined as possible; it's really a sort of debug-printer except when used to display strings or symbols.

=== #447 #!fold-case and #!no-fold-case have no final delimiter ===

The `#!fold-case` and `#!no-fold-case` directives are read as
comments, which means that they are treated as whitespace (section
2.2).  Unlike the other kinds of comments, their final delimiter is
implicit.  This means that `(1#!no-fold-cases)` reads as `(1 s)`.
This seems unfortunate.

  * '''Proposals:''' 
    * '''identifier:''' add the formal syntax `<lexical-directive> --> #! <identifier>` and then make the interpretation of `<identifier>` implementation-dependent, except for the standard cases `#!fold-case` and `#!no-fold-case`. (Per Bothner, Richard Kelsey)
    * '''delimiter:''' the directives must be followed by delimiter (John Cowan)
    * '''comment:''' the draft status-quo
  * '''Options:''' identifier, delimiter, comment, undecided
  * '''Default:''' comment
  * '''Preferences:''' delimiter
  * '''Rationale:'''  Most of the time case-folding directives will be delimited by newline or space anyway.  I see no point in adding yet another class of magic implementation-dependent things to the standards: implementations can do what they will anyway.

=== #442 write procedure is not backwards compatible ===

There is concern that the output of `write` cannot be read by non-R7RS
implementations.  This is not a strict requirement, but is reasonable
if using simple sexp-based file/interchange formats.

Specifically, even though there are no cycles in

  `(let ((x (list 2))) (write (list x x)))`

it previously output "((2) (2))" but now outputs "(#0=(2) #0#)".

The WG concern is that R5RS write is unsafe, easily causing infinite
loops, and should therefore not be the default.  Thus we renamed this
"write-simple", requiring programmers to know they are writing a
"simple" data structure up front.

Arguably, there are three procedures desired:

  * write-cyclic: uses labels only to avoid cycles
  * write-shared: uses labels for all shared structure
  * write-simple: won't use labels - it is an error to pass a cyclic structure

although even for `write-shared` people sometimes want to treat
containers such as strings separately.

Note the algorithms for detecting shared structure differ from those
for detecting cycles, so providing both -shared and -cyclic imposes an
additional implementation burden.

  * '''Proposals:'''
    * '''write+simple:''' the current draft status quo
    * '''write+shared:''' change `write` back and add `write-shared` to explicitly handle sharing
    * '''write+cyclic:''' change `write` back and add `write-cyclic` to handle only cycles
    * '''write+shared+cyclic:''' change `write` back and add both `write-shared` and `write-cyclic`
    * '''write+simple+shared:''' `write` handles cycles only, provide `write-simple` and `write-shared` separately
  * '''Options:''' write+simple, write+shared, write+cyclic, write+shared+cyclic, write+simple+shared, unspecified, undecided
  * '''Default:''' write+simple
  * '''Preferences:''' undecided

=== #443 Recommend sources of character names ===

Currently, we allow implementations to provide their own names for
characters, but provide no guidance for them.  There are two plausible
sources: the [http://unicode.org/Public/UNIDATA/NamesList.txt names in
the Unicode Standard], and the [http://www.w3.org/TR/xml-entity-names/
entity names specified by W3C] for use in HTML, MathML, and other
markup standards (ultimately derived from ISO SGML character entity
sets).

The Unicode names are in all upper case and contain significant spaces
and apostrophes as name characters, which would require some mapping
to make valid Scheme identifiers.  The W3C name list is incomplete
though fairly large (currently 2237 names), covering mainly the Greek
and Cyrillic scripts and non-ASCII punctuation and symbols.  It
distinguishes between iota (small) and Iota (capital).

Vote `w3c` for the W3C list, `unicode` to use the Unicode list with
names mapped by converting to lowercase and replacing any
non-identifier character (space and apostrophe) with hyphens.  Vote
`unspecified` to leave the character name extensions entirely up to
the implementation.

  * '''Options:''' w3c, unicode, unspecified, undecided.
  * '''Default:''' unspecified
  * '''Preferences:''' w3c
  * '''Rationale:'''  The W3C list is a good useful compromise, refined over decades of SGML use.

== WG1 - Base Library ==

=== #140 Removing `quotient`, `remainder`, `modulo` ===

With the acceptance of #278, we reduced the set of division operators
to `truncate-*` and `floor-*` and move these into the base library.
Three of these procedures are simply aliases for `quotient`,
`remainder` and `modulo`, so it is worth considering removing the old
names.

Since the old names are in IEEE Scheme we need strong justification
for removing them from (scheme base), and even if we do so they will
remain available in (scheme r5rs).

We have precedence for changing names, but only in the case when the
existing names were both actively misleading and had already been
changed in R6RS.  Specifically, in ticket #328 we replaced the names
`inexact->exact` and `exact->inexact` with the more accurate `exact`
and `inexact`.

Arguably the new division operator names are clearer, but the old
names are not actually misleading.

Vote `yes` to remove the old names from (scheme base), or `no` to
leave them in as aliases.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  It's silly to have both sets of names in the base library.

=== #378 Rename GET-FEATURES to just FEATURES ===

This is compatible with Chicken, and "more Scheme-like, less
Java-like".  Okay, it's bikeshedding.

  * '''Options:''' features, get-features, undecided
  * '''Default:''' get-features
  * '''Preferences:''' features
  * '''Rationale:'''  I don't even know why I made this `get-features` when I proposed it.

=== #384 Merge `bytevector-copy` and `bytevector-copy-partial` ===

Under this proposal, the name would be `bytevector-copy` and the
signature would be

  `(bytevector-copy `''bytevector'' [''start'' [''end'']]`)`

Vote `yes` for this simplification.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  This is in conformity with the way we do string and vector copiers now, as well as the destructive `bytevector-copy!`.

=== #385 Merge `write-bytevector` and `write-bytevector-partial` ===

One proposal is `port-last` with a signature of:

  `(write-bytevector ''bytevector'' [''start'' [''end'' [''port'']]])`

This has the disadvantage of being required to call
`bytevector-length` when writing to a specific port.

Alternately we could do `offsets-last`:

  `(write-bytevector ''bytevector'' [''port'' [''start'' [''end'']]])`

which has the disadvantage of separating the bytevector from its
offsets.

Alternately, vote `separate` to keep these as two separate procedures.

  * '''Options:''' port-last, offsets-last, separate, undecided
  * '''Default:''' separate
  * '''Preferences:''' offsets-last
  * '''Rationale:'''  I think the port is less important than the stop/start.

=== #387 Add start/end arguments to string->vector and vector->string ===

This is a proposal to add optional start (inclusive) and end
(exclusive) arguments to `string->vector` and `vector->string`.  We
now have start (inclusive) and end (exclusive) arguments for
`string->list` and `vector->list`, but our non-R5RS and non-SRFI
procedures to convert directly between strings and vectors don't
provide these.

Vote `yes` to add these optional arguments.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  Consistency and completeness.

=== #391 Add predicates for R7RS signalled conditions ===

R7RS requires an error to be signalled (which means an exception is
raised as if by `raise`) in the following circumstances:

 1. Trying to open for input or delete a file that does not exist or is otherwise inaccessible.
 1. Specifying an argument to `scheme-report-environment` that the implementation doesn't support.  (It must support 7 and may support other values.)
 1. An EOF is encountered while `read` is in the middle of a datum.
 1. Using `expt` to raise zero to the power of a non-real number (alternatively an arbitrary number may be returned).

This proposal is to provide four standard predicates that identify
these specific conditions, to be used in `guard` clauses or in
`with-exception` handlers as a portable means of detecting these
errors.  Although these predicates may return `#t` on other objects,
if one reports `#t` on an object, the others must report `#f`.
Proposed names are `file-error?`, `scheme-report-error?`,
`read-error?`, and `expt-error?` respectively.

Vote `yes` to add these procedures, or `file-only` to only add the
`file-error?` predicate.

  * '''Options:''' yes, file-only, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  There are only a few standard traps, and we should be able to identify which one we have.  I can't think of any reason for providing `file-error` but not the others.

=== #400 Define record? . ===

We should define the predicate record? so that it's possible to
distinguish instances of record types from all other types.  It should
not be necessary to enumerate all record type predicates in order to
determine whether an object is an instance of a record.

This is Alexey Radul's suggestion.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' no
  * '''Rationale:'''  No, no, a thousand times no.  The large language may want to introduce opaque records (records that look like primitive types to the outside world) and this would effectively prevent it.  Redefining `record?` within a library wouldn't be enough, as it would permit opaque records to be recognized as such as soon as they were passed out of the library.

=== #425 Add read-string, read-string!, write-string procedures to (scheme base) ===

This was requested by Formal Comment #424.

These procedures would be provided for parallelism with the
byte-vector I/O operations:

||Byte||Character||Bytevector||String||
||read-u8||read-char||read-bytevector(!)||read-string(!)||
||write-u8||write-char||write-bytevector||write-string||

If #385 passes, optional ''start'' (inclusive) and ''end'' (exclusive)
index arguments would be added to `write-string`.  Otherwise
`write-partial-string` would be provided.

Vote `yes` to add all three, `immutable` to add only `read-string` and
`write-string`, or `no` to leave them out.

  * '''Options:''' yes, immutable, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  As soon as we voted in `string-copy!`, the goal of immutable strings died a horrible death.  We should have all of these for bulk I/O.

=== #433 full conversion cycle for containers ===

Marc Feeley proposes it should be possible to convert from any
container type to another, possibly via an intermediary such as

  `(list->B (A->list a))`

proposing specifically "list" be the universally available
intermediary, although "vector" would also be worth considering.

The container types are list, vector, string and bytevector.  String
and bytevector are second-class in that they are not general-purpose
container types, and may raise errors converting from lists or
vectors.

Vote `list` for the proposal to add the following procedures to
complete the cycle:

  * list->bytevector
  * bytevector->list

Vote `vector` to add the equivalent procedures to allow converting
between any of the types and vectors, specifically the following two
new procedures:

  * vector->bytevector
  * bytevector->vector

The `latin-1` proposal also adds the Latin-1-centric ideas of string to
bytevector conversion, where each element of the bytevector is
converted to/from a character with char->integer/integer->char.

The `matrix` proposal requires all 4^3^=64 conversions.

  * '''Options:''' matrix, list, vector, latin-1, no, undecided
  * '''Default:''' no
  * '''Preferences:''' list+vector
  * '''Rationale:'''  Conversions between bytevectors and lists/vectors are sensible, but doing Latin-1 conversions isn't a particularly sensible conversion between strings and bytevectors.

=== #444 Add vector-append procedure ===

This is for completeness with `append` and `string-append`.  See #436
for the Formal Comment that triggered this ticket.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  Consistency and completeness.

=== #451 Add bytevector-append procedure ===

This is for consistency with `append`, `string-append`, and
`vector-append` (per ticket #444) procedures.  It is useful for the
reconstruction phase of divide-and-conquer algorithms on arbitrary
byte sequences.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  Consistency and completeness.

=== #445 Bidirectional ports and port-open? ===

Replace `port-open?` with `input-port-open?` and `output-port-open?`,
since a bidirectional port can be closed on one side without the
other.  See Formal Comment #439.

Vote `replace` to replace `port-open?` with just the two new versions,
or `add` to have all three.

  * '''Options:''' replace, add, no, undecided
  * '''Default:''' no
  * '''Preferences:''' replace
  * '''Rationale:'''  It's better to keep these separate, even if marginally less convenient.

=== #450 Eliminate default for fill argument in vector-copy ===

Marc Feeley writes:

It is a bad idea for the ''fill'' parameter of `vector-copy` to have a
default. When ''fill'' is absent, it should be an error when ''start''
and ''end'' are not within the bounds of the sequence. Otherwise, some
index calculation errors (off-by-one on ''end'') may go
unnoticed. Moreover, when it is supplied, ''fill'' should also be used
when ''start'' is less than 0, for consistency with the case where
''end'' is greater to the length of the sequence.

Vote `required` to make the fill parameter required, `error` to make
it an error in the case that fill is absent yet needed, or `default`
for the current status quo.

  * '''Options:''' required, error, default, undecided
  * '''Default:''' default
  * '''Preferences:''' default
  * '''Rationale:'''  This routine comes from SRFI-43 and should be kept compatible with it.

=== #404 Make handlers take a raise-continuable? argument. ===

Pass exception handlers a second, Boolean argument that declares
whether the exception is continuable.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' no
  * '''Rationale:'''  Given that Scheme has no way of calling procedures portably when the number of arguments they accept is unknown, I have to reluctantly reject this, even though it is clearly the Right Thing.  Many handlers will not care, and they should not be required to be retrofitted with a dummy second argument.

== WG1 - Optional Libraries ==

=== #373 (exit #t) should be the same as (exit) ===

See Formal Comment #372 for the argument.  Cowan writes: "I support this proposal.  I
don't support the alternative proposal to just say that any true value
reports success and only #f reports failure, for there is usually only
one kind of success (0 on Posix and Windows, "" on Plan 9, 2 on VMS)
and many kinds of failure."

It is reasonable and convenient to use `#t`/`#f` as generic
success/failure for portable programs, with `(exit)` as a shorthand
for the "normal" completion `(exit #t)`.

Another reasonable extension is fallback for certain success values
that the implementation cannot understand.  Specifically, `0` is
commonly used for success on Posix systems, and the empty string "" as
success on Plan9.  We could require that if the implementation does
not know how to pass these value types (string or number) to the OS,
then it should recognize `0` and `""` as true.  Any value other than
these which cannot be passed to the OS should be treated as a generic
error.  That way, a program written for Posix that alternatively uses
`(exit 0)` and `(exit <n>)` will still work as desired on a Plan9
system, only losing details of the type of failure (and likewise for
Plan9 programs running on Posix).

In either case, unless someone makes a proposal to the contrary,
unknown values should always be treated as generic failure, and never
raise an exception or fail to exit (from #374).

  * '''Proposals:''' 
    * '''boolean:''' Only `#t`/`#f` are as described as above, and all other values are passed (as best as possible) to the OS and therefore implementation-defined
    * '''extended-true:''' `#f` is generic failure, `#t` generic success, and `""` and `0` are generic success if not otherwise understood by the OS
  * '''Options:''' boolean, extended-true, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' boolean
  * '''Rationale:'''  `Extended-true` is going too far: 0 means success on many systems, but failure (specifically: failure of unknown origin) on VMS.  Portable code should stick with `#t` and `#f`.

=== #375 Add EMERGENCY-EXIT procedure ===

This procedure provides instant guaranteed process exit without
running `dynamic-wind` thunks.  This is a low-level and dangerous
procedure.

Vote `emergency-exit` to add this procedure, or `no` to leave it out.
If you want to write in an alternate name, be sure to include
`emergency-exit` as a secondary option after it.

  * '''Options:''' emergency-exit, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  Given that `exit` unwinds thunks, this is needed.  It should also call `_exit()` on Posix and Windows, so stdio buffers are not flushed either.

=== #394 Ditching SCHEME-REPORT-ENVIRONMENT and NULL-ENVIRONMENT ===

Cowan writes:

"I have reluctantly come to the same conclusion as the R6RS editors:
that in a Scheme with libraries, `scheme-report-environment` and
`null-environment` don't make much sense.  They are not in IEEE Scheme
or R4RS, so there is no formal barrier to removing them.

"Semantically, `scheme-report-environment` holds all the identifiers in
R5RS, excepting any which the implementation doesn't provide, like
`make-rectangular` if it does not have complex numbers.
`Null-environment`, on the other hand, contains only the syntax
keywords with none of the standard procedures: it is not an empty
environment.  R6RS preserves these procedures only in the R5RS
compatibility library, where they expose only R5RS content.

"When adapting the definition to R7RS, I changed
`scheme-report-environment` to contain all the identifiers in all the
standard libraries that the implementation provides, and
`null-environment` all the syntax keywords in those libraries.  This
was the best I thought I could do, but now I think that it provides
very little utility.

"It's possible to construct any specific environment you want by using
the `environment` procedure, which turns a sequence of import-specs
into an environment.  In particular, we now have the `(scheme r5rs)`
library, which essentially provides what
`(scheme-environment-procedure 5)` should provide, and there is no
portable use of any argument other than 5."

Vote `remove` to remove these two procedures entirely, or `move` to
move them from (scheme eval) and provide them only as portability
options in `(scheme r5rs)`, where only the argument 5 is required to
be supported.  Vote `keep` to leave them as-is.

  * '''Options:''' remove, move, keep, undecided
  * '''Default:''' keep
  * '''Preferences:''' move
  * '''Rationale:'''  These do no harm in the R5RS-compatibility library, but are actively harmful (because misleading) in the `eval` library where they are today.

=== #413 EVAL accepts DEFINE ===

The proposal is to require `eval` to accept definitions as well as
expressions, as long as the specified environment is mutable.  See
EvalDefine for which Schemes already handle this.

  * '''Options:''' yes, no, unspecified, undecided
  * '''Default:''' no
  * '''Preferences:''' undecided

=== #399 clarify which primitives are allowed to implicitly force ===

The standard allows the following extension to force:

  Some implementations may implement "implicit forcing," where the
  value of a promise is forced by primitive procedures like `cdr'
  and `+'

We should remove this note or tighten the definition.

A simple definition is any primitive that would require a type-check
can perform implicit forcing.  This would include all type predicates
themselves except for `promise?`.  Note if #405 passes, then in
implementations which support this extension an object could return
`#t` for `promise?` in addition to one other type.

  * '''Options:''' remove, type-check, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' type-check
  * '''Rationale:'''  The `type-check` rule is sensible and clear.

=== #405 Make promises first-class ===

Currently there is no way to inspect an object to see if it's a
promise.  This proposal makes promises first-class by adding a
`promise?` predicate.  It also requires that if the argument to
`make-promise` is a promise, it is returned without rewrapping it, and
that if `force` is given a non-promise argument, it returns it
unchanged.  (These things cannot be provided by the user without a
`promise?` predicate, and are trivial to provide with it.)

Vote `disjoint` to add `promise?` and make it a disjoint type, or
`yes` to add it as a not-necessarily disjoint predicate.

  * '''Options:''' disjoint, yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' disjoint
  * '''Rationale:'''  Promises should be disjoint, specifically disjoint from procedures.  See DisjointProcedures for which are and which are not.

=== #462 end of line definition ===

The definition of read-line allows implementation defined extensions
to the set of end of line sequences. This is arguably too loose, as an
implementation could define "a" as and end of line. On the other hand,
if we do want to leave this in it may make sense to remove "\r", which
is no longer used in any contemporary OS.

Vote `no-extensions` to forbid implementation defined extensions,
`no-return` to remove a single return from the list of required end of
lines, and `none` to leave as-is.

  * '''Options:''' no-extensions, no-return, none, undecided
  * '''Default:''' none
  * '''Preferences:''' none
  * '''Rationale:'''  The implementation-defined extensions is for the sake of R6RS systems that treat EBCDIC NEL and Unicode LS as line delimiters (a la XML 1.1, both my doing, I fear).  Defining "a" as a line ending is a quality of implementation issue; the standard does not need to forbid implementations from being stupid, because nobody will use such an implementation.

=== #452 provide digit-value support for hex-digits ===

In ballot 4, in symmetry with the new Unicode definition of
`char-numeric?` and as an analog to CL's `digit-char-p`, we provided
`digit-value`.

An informal comment was made questioning this procedure, and
suggesting if provided at all it be extended to hex digits.

Vote `ascii-hex` to support only the ASCII hex digits a-f,A-F (in
addition to full Unicode numeric digits), `unicode-hex` to support all
Unicode variants of a-f,A-F (need to define formally), `remove` to
remove `digit-value` entirely, or `keep` to keep as is.

  * '''Options:''' ascii-hex, unicode-hex, remove, keep, undecided
  * '''Default:''' keep
  * '''Preferences:''' ascii-hex
  * '''Rationale:'''  `Ascii-hex` spoils the theoretical purity of `digit-value`, but it's handy to have packaged in the same framework, and we can certainly say it is provided for convenience.

== WG1 - Non-normative ==

=== #411 Reference implementation ===

Our charter calls for one or more reference implementations.  As of
today, Chibi is very close to being so.  The proposal is to bless it
as a sample or model implementation, but not technically a reference
implementation -- if it disagrees with the standard, the standard
wins.

  * '''Options:''' yes, no, undecided
  * '''Default:''' no
  * '''Preferences:''' yes
  * '''Rationale:'''  Chibi is the de facto model implementation, and we may as well say so.  It's small, easy to understand, and does a lot of things directly in Scheme.

=== #463 library naming conventions  ===

We currently use the singular form of data types for library names,
e.g. `(scheme char)` and `(scheme file)`.  R6RS prefers the plural, as
in `(scheme lists)` and `(scheme records)`. We should decide
officially which is preferred.

  * '''Options:''' singular, plural, unspecified, undecided
  * '''Default:''' unspecified
  * '''Preferences:''' singular
  * '''Rationale:'''  This is a matter of taste, but I like the singular form and see no reason to change it.

time

2012-07-10 14:59:52

version

44