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: bug#7696: 24.0.50; Elisp manual, doc of `mode-name' and `major-mode' Date: Mon, 20 Dec 2010 20:27:16 -0800 Message-ID: <82D1404D4CF749D886386C2656CC2DAE@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1292907196 20588 80.91.229.12 (21 Dec 2010 04:53:16 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 21 Dec 2010 04:53:16 +0000 (UTC) To: 7696@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Dec 21 05:53:12 2010 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.69) (envelope-from ) id 1PUuDn-0005Bx-0r for geb-bug-gnu-emacs@m.gmane.org; Tue, 21 Dec 2010 05:53:11 +0100 Original-Received: from localhost ([127.0.0.1]:48196 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PUuDm-0001yE-GZ for geb-bug-gnu-emacs@m.gmane.org; Mon, 20 Dec 2010 23:53:10 -0500 Original-Received: from [140.186.70.92] (port=52513 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PUuDc-0001xO-En for bug-gnu-emacs@gnu.org; Mon, 20 Dec 2010 23:53:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PUuDb-0007WW-3t for bug-gnu-emacs@gnu.org; Mon, 20 Dec 2010 23:53:00 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:53076) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PUuDb-0007WS-2P for bug-gnu-emacs@gnu.org; Mon, 20 Dec 2010 23:52:59 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PUtif-000221-TJ; Mon, 20 Dec 2010 23:21:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 21 Dec 2010 04:21:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7696 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.12929052567797 (code B ref -1); Tue, 21 Dec 2010 04:21:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 21 Dec 2010 04:20:56 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PUtia-00021h-2a for submit@debbugs.gnu.org; Mon, 20 Dec 2010 23:20:56 -0500 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PUtiX-00021W-SW for submit@debbugs.gnu.org; Mon, 20 Dec 2010 23:20:54 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PUtop-0003Hr-SR for submit@debbugs.gnu.org; Mon, 20 Dec 2010 23:27:25 -0500 Original-Received: from lists.gnu.org ([199.232.76.165]:47125) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PUtop-0003Hn-My for submit@debbugs.gnu.org; Mon, 20 Dec 2010 23:27:23 -0500 Original-Received: from [140.186.70.92] (port=37833 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PUtoo-0003PY-0f for bug-gnu-emacs@gnu.org; Mon, 20 Dec 2010 23:27:23 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PUtom-0003HB-C0 for bug-gnu-emacs@gnu.org; Mon, 20 Dec 2010 23:27:21 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]:61514) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PUtom-0003Gw-5o for bug-gnu-emacs@gnu.org; Mon, 20 Dec 2010 23:27:20 -0500 Original-Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id oBL4RHfk019240 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 21 Dec 2010 04:27:18 GMT Original-Received: from acsmt354.oracle.com (acsmt354.oracle.com [141.146.40.154]) by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id oBL4RGSl004020 for ; Tue, 21 Dec 2010 04:27:17 GMT Original-Received: from abhmt012.oracle.com by acsmt353.oracle.com with ESMTP id 892045971292905632; Mon, 20 Dec 2010 20:27:12 -0800 Original-Received: from dradamslap1 (/10.159.239.22) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 20 Dec 2010 20:27:11 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Acugx1kiTxxGBU0YRWKzE0SeOFiA4w== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Mon, 20 Dec 2010 23:21:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org 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:42695 Archived-At: (elisp) Auto Major Mode documents variable `major-mode'. (elisp) Major Mode Conventions documents variable `mode-name'. 1. `major-mode' doesn't really have much to do with How Emacs Chooses a Major Mode. Or, rather, it has to do with that and many other things equally. So I don't think this is a great place to document this var. 2. More importantly, users sometimes look for the pretty name of the major mode, which is the value of var `mode-name'. They won't find it by looking for anything associated with "major", since the name doesn't reflect that (unfortunately). At the very least, we should have an index entry that reflects the search for such a variable using "major": `major-mode name'. (It might not even be a bad idea to create an alias, `major-mode-name', for `mode-name'.) Most importantly in this regard, there should be a cross-ref from the description of `major-mode' to the node that describes `mode-name'. Better would be to also mention `mode-name' at that location. In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600) of 2010-12-20 on 3249CTO Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (4.4) --no-opt --cflags -Ic:/imagesupport/include'