bug-gnu-emacs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

RE: doc of eval-defun (C-M-x)


From: Drew Adams
Subject: RE: doc of eval-defun (C-M-x)
Date: Tue, 10 Jul 2007 09:19:28 -0700

> >    Nodes `Defining Variables'
> >    and `Variable Definitions' should be indexed for `eval-defun'.
>
> Can you explain why?  `eval-defun' is fully described in the Emacs
> manual (and indexed there), so why would we need to describe it again
> in the ELisp manual?

It's already described in the Elisp manual. I'm asking that the existing
description be indexed.

As to explaining why it should be indexed, that explanation is now
irrelevant, unfortunately, since RMS has said:

> We don't use the index that way.

Nevertheless, FWIW, my thinking was that, since `eval-defun' is discussed in
that node, and this use of `eval-defun' is as common as the `edebug' use
(IMO), it would be good to help readers find the discussion of `eval-defun'
in the context of `defvar' and `defcustom' (and `defface' as well). We index
the edebug discussion of `eval-defun'; we should also index the use with
`C-M-x', which is just as common.

This is in the Elisp manual presumably because Emacs-Lisp programmers are
interested in it, and indexing it helps them find it. IMO, Emacs-Lisp
programmers are also those most likely to use `C-M-x' (`eval-defun').






reply via email to

[Prev in Thread] Current Thread [Next in Thread]