Re: Documentation

[Marius Vollmer]

Neil Jerram <address@hidden> writes:

> I just realized that, notwithstanding Scheme's emphasis on values as
> opposed to names, documentation is almost always about names, aka
> interfaces, aka bindings, and only rarely about values.

Right. 

> It's then a simple matter of policy :-) to decide whether we are happy
> to let `define' stand for `define/documented' in either or both of the
> two cases above.

I would be happy with that, for what it's worth.

I can imagine making a even broader distinction between (define name
val) and (define (name args) body).  For example, I wouldn't have any
problems with letting the latter define a constant binding that can
not be altered with `set!'.