From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Newsgroups: gmane.emacs.devel,gmane.emacs.pretest.bugs Subject: 23.0.50; `mode-name' variable docs out of date WRT features Date: 30 Dec 2007 19:12:50 -0000 Message-ID: <20071230191250.1839.qmail@priss.frightenedpiglet.com> NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1199044904 22398 80.91.229.12 (30 Dec 2007 20:01:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 30 Dec 2007 20:01:44 +0000 (UTC) To: emacs-pretest-bug@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 30 21:01:59 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1J94M9-0007ip-GB for ged-emacs-devel@m.gmane.org; Sun, 30 Dec 2007 21:01:57 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J94Lo-0007i3-65 for ged-emacs-devel@m.gmane.org; Sun, 30 Dec 2007 15:01:36 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1J93ZU-0007A1-P1 for emacs-devel@gnu.org; Sun, 30 Dec 2007 14:11:40 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1J93ZS-00078F-Ta for emacs-devel@gnu.org; Sun, 30 Dec 2007 14:11:40 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1J93ZS-000781-MQ for emacs-devel@gnu.org; Sun, 30 Dec 2007 14:11:38 -0500 Original-Received: from fencepost.gnu.org ([140.186.70.10]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1J93ZS-0001jM-De for emacs-devel@gnu.org; Sun, 30 Dec 2007 14:11:38 -0500 Original-Received: from mx10.gnu.org ([199.232.76.166]) by fencepost.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1J93ZS-0000J5-7v for emacs-pretest-bug@gnu.org; Sun, 30 Dec 2007 14:11:38 -0500 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1J93ZO-0001if-Sm for emacs-pretest-bug@gnu.org; Sun, 30 Dec 2007 14:11:37 -0500 Original-Received: from v-static-143-234.avvanta.com ([206.124.143.234] helo=priss.frightenedpiglet.com) by monty-python.gnu.org with smtp (Exim 4.60) (envelope-from ) id 1J93ZO-0001hk-Ae for emacs-pretest-bug@gnu.org; Sun, 30 Dec 2007 14:11:34 -0500 Original-Received: (qmail 1840 invoked by uid 1000); 30 Dec 2007 19:12:50 -0000 X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 2) X-detected-kernel: by monty-python.gnu.org: Linux 2.6, seldom 2.4 (older, 4) X-Mailman-Approved-At: Sun, 30 Dec 2007 15:01:31 -0500 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:85700 gmane.emacs.pretest.bugs:20487 Archived-At: Recent Emacs snapshots have extended the `mode-name' variable, so that constructs such as '(sgml-xml-mode "XML" "SGML") are allowed. (See, for example, the definition of `sgml-mode'.) The documentation does not cover this list representation at all. The node "(elisp) Major Mode Conventions" states: * The major mode command should set the variable `mode-name' to the "pretty" name of the mode, as a string. This string appears in the mode line. and the node "(elisp) Mode Line Variables" states: -- Variable: mode-name This buffer-local variable holds the "pretty" name of the current buffer's major mode. Each major mode should set this variable so that the mode name will appear in the mode line. which implies (via "pretty") that this is a string, but doesn't actually say what is allowed and what isn't. The docs need to be updated to describe the new list-based representation and how it is interpreted. Derek