[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Access to documentation strings
- To: Fahlman at CMU-20C
- Subject: Access to documentation strings
- From: Kent M. Pitman <KMP at MIT-MC>
- Date: Mon, 30 Aug 1982 04:45:00 -0000
- Cc: Common-Lisp at SU-AI
Date: Thursday, 26 August 1982 21:17-EDT
From: Scott E. Fahlman <Fahlman at Cmu-20c>
... If we want anything of this sort, the convention should be that the
first SENTENCE (normal English syntax) is an overview. My preference
would be to forget this whole overview business -- I don't see much use
for it.
-----
Experience with Teco/Emacs shows that these two types of documentation are
tremendously useful to users. I have to say, though, that I've been bothered
on innumerable occasions by the restriction of its being a one-liner.
Exceptions always come up. The same would happen with a one-sentence
restriction only worse because finding the end of a sentence is a natural
language task in some cases. I really think having a mechanism that its
structure is necessary to make the thing useful.