From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: RE: Shouldn't directory-abbrev-alist be in Emacs manual? Date: Tue, 26 Feb 2008 08:53:40 -0800 Message-ID: <003201c87898$24244ce0$0600a8c0@us.oracle.com> References: <87ve4cwu86.fsf@stupidchicken.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1204044863 22495 80.91.229.12 (26 Feb 2008 16:54:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 26 Feb 2008 16:54:23 +0000 (UTC) To: "'Chong Yidong'" , Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Feb 26 17:54:48 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JU34p-0002eW-PM for geb-bug-gnu-emacs@m.gmane.org; Tue, 26 Feb 2008 17:54:48 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JU34K-0002cP-8c for geb-bug-gnu-emacs@m.gmane.org; Tue, 26 Feb 2008 11:54:16 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JU34E-0002b2-Oi for bug-gnu-emacs@gnu.org; Tue, 26 Feb 2008 11:54:10 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JU34C-0002ZL-Bp for bug-gnu-emacs@gnu.org; Tue, 26 Feb 2008 11:54:09 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JU34B-0002Z5-V6 for bug-gnu-emacs@gnu.org; Tue, 26 Feb 2008 11:54:08 -0500 Original-Received: from agminet01.oracle.com ([141.146.126.228]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JU34B-0007WG-Af for bug-gnu-emacs@gnu.org; Tue, 26 Feb 2008 11:54:07 -0500 Original-Received: from agmgw2.us.oracle.com (agmgw2.us.oracle.com [152.68.180.213]) by agminet01.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id m1QGs4Uo014674; Tue, 26 Feb 2008 10:54:04 -0600 Original-Received: from acsmt350.oracle.com (acsmt350.oracle.com [141.146.40.150]) by agmgw2.us.oracle.com (Switch-3.2.0/Switch-3.2.0) with ESMTP id m1Q6UKhD030384; Tue, 26 Feb 2008 09:54:03 -0700 Original-Received: from inet-141-146-46-1.oracle.com by acsmt350.oracle.com with ESMTP id 3590928671204044816; Tue, 26 Feb 2008 08:53:36 -0800 Original-Received: from dradamslap1 (/141.144.66.36) by bhmail.oracle.com (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 26 Feb 2008 08:53:35 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <87ve4cwu86.fsf@stupidchicken.com> Thread-Index: Ach3/WXlm+DqBajHT9CE9cCtqBuNNwAmSzXA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3198 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:17597 Archived-At: > > 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.