From: "Drew Adams" <drew.adams@oracle.com>
To: "'Chong Yidong'" <cyd@stupidchicken.com>, <bug-gnu-emacs@gnu.org>
Subject: RE: Shouldn't directory-abbrev-alist be in Emacs manual?
Date: Tue, 26 Feb 2008 08:53:40 -0800 [thread overview]
Message-ID: <003201c87898$24244ce0$0600a8c0@us.oracle.com> (raw)
In-Reply-To: <87ve4cwu86.fsf@stupidchicken.com>
> > It is a user option. It is described in the Elisp manual, but not in
> > the Emacs manual, where users might want to know about it.
>
> After thinking about this a little, I feel that it's too much of a
> niche option to warrant mentioning in the Emacs manual, which after
> all doesn't aim to document every single user option. Does anyone
> feel strongly that it should be discussed in the manual?
It's not about "document[ing] every single user option". That's a straw man.
The point is that this option *is* discussed in the manual already, but it
is in the wrong manual. It belongs in the Emacs manual, not in the Elisp
manual (or perhaps it belongs in both; I don't know).
It is a user option, intended for user customizing, not only for Lisp
programming. Users who will use it need not know Emacs Lisp at all. They
should not need to read the Elisp manual to find out about the option.
Either it is useful for non-Lispers or it is not. If it is, then, if it is
documented, the proper manual for that is the Emacs manual.
prev parent reply other threads:[~2008-02-26 16:53 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-10-02 16:06 Shouldn't directory-abbrev-alist be in Emacs manual? Drew Adams
2008-02-25 22:23 ` Chong Yidong
2008-02-26 16:53 ` Drew Adams [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='003201c87898$24244ce0$0600a8c0@us.oracle.com' \
--to=drew.adams@oracle.com \
--cc=bug-gnu-emacs@gnu.org \
--cc=cyd@stupidchicken.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).