[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Documentation strings and function.
- To: Fahlman@C.CS.CMU.EDU
- Subject: Re: Documentation strings and function.
- From: Bobrow.pa@Xerox.COM
- Date: Thu, 04 Sep 1986 17:56:00 -0000
- Cc: allen@BFLY-VAX.BBN.COM, Common-Lisp@SU-AI.ARPA
- In-reply-to: "Scott E. Fahlman" <Fahlman@C.CS.CMU.EDU>'s message of Thu, 4 Sep 86 12:44 EDT
I think multiple document strings should be allowed. Perhaps all should
precede any declarations. The argument for multiple document strings is
that one can then use a simple parsing program to collect documentation
from code. One could imagine a convention of the first document string
describing the external interface or purpose of a document, and the
second information about the implementation. Why isn't the syntax
... lambda-list {documentation}* {declarations}* ...
-- danny