Re: Documentation

[Neil Jerram]

>>>>> "Jorgen" == Jorgen 'forcer' Schaefer <address@hidden> writes:

    Jorgen> Weren't there plans to have properties for objects, via a
    Jorgen> hash table?  Wouldn't it be possible to have a
    Jorgen> 'documentation binding for each object?
    Jorgen> E.g. #<primitive-procedure car> instead of 'car?

For most objects, yes, where it makes sense for the documentation to
attach to the object's _value_.

But there are some cases where it makes sense for documentation to
describe not a value but a _binding_, for example an exported variable
that parameterises a module's behaviour in different ways according to
the value that is stored in that variable.  Like `case-fold-search' in
Emacs.  What we're discussing now is the details of implementing
docstrings for such bindings.

Regards,
        Neil