Re: :documentation

[David A. Moon <Moon@STONY-BROOK.SCRC.Symbolics.COM>]

That's an interesting piece of input which changes some
things.

I would suggest, then, that the :documentation slot-option should be
put in, and that it should not set the documentation of any function
or method.  Instead, it should set the documentation of the slot,
which requires the chapter 2 function documentation to be enhanced to
accept slot-descriptions as well as the other meta-objects it accepts,
and the chapter 3 specification of slot-descriptions to be enhanced to
mention that they have documentation that can be initialized, read,
and written.  As with all Common Lisp documentation strings, what use
if any is made of this data is implementation-dependent; CLOS just
provides a place to store it.