Re: RE: [Ilisp-devel] Re: Using Emacs as a Lisp IDE

On Tue, Jul 15, 2003 at 08:30:35AM -0600, Clementson, Bill wrote:

> My personal feeling is that the ILISP texi file shouldn't have any
> keybindings in it at all - only commands. The "C-h m" output provides a
> very good summary of the keybindings and commands and I refer to it when
> I'm looking up keybindings rather than the documentation. However, that
> is just my viewpoint. How do others feel about this?

IMHO, the main value for keybinding documentation is easing the
learning curve.  

People who are new to both emacs and Common Lisp
aren't in the most enviable of positions as it is: for them there is
great value in being able to find keybindings by searching the
documentation for such. ;)

Also, during the early learning stages a list of keybindings is a good
learning tool as it is pretty much equivalent to "frequently used
commands".

I've used emacs for a few years, but "C-h m" isn't something I yet do by
reflex. I probably should, but I'm only bringing this up to illustrate
that overcoming emacs-cluelessness is a long-term project for at least
some of it's users.

That said, I can most certainly understand you reluctance to maintain
multiple sets of documentation...

Hence I'd suggest mentioning the "C-h m" &co under "Keybindings" in
the Ilisp documentation. Or maybe a "Short Guide to Developing with
Ilisp" would be the correct solution.

Cheers,

 -- Nikodemus

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.1 (GNU/Linux)

iD8DBQE/FBY5bSpkIAKPfsURAtMEAJ0Tz9Jm66lDbCl1kRFLzf3qBvHcYQCZAT/t
ZJnCVP0pqNYgjpU4szwRS/o=
=WYDq
-----END PGP SIGNATURE-----