From: <sand@priss.frightenedpiglet.com>
To: emacs-pretest-bug@gnu.org
Subject: 23.0.50; `mode-name' variable docs out of date WRT features
Date: 30 Dec 2007 19:12:50 -0000 [thread overview]
Message-ID: <20071230191250.1839.qmail@priss.frightenedpiglet.com> (raw)
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
next reply other threads:[~2007-12-30 19:12 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-12-30 19:12 sand [this message]
2007-12-31 14:42 ` 23.0.50; `mode-name' variable docs out of date WRT features Richard Stallman
2008-01-02 2:55 ` Stefan Monnier
2008-01-02 3:06 ` Miles Bader
2008-01-02 4:22 ` Stefan Monnier
2008-01-03 9:50 ` Richard Stallman
2008-01-10 2:16 ` Glenn Morris
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=20071230191250.1839.qmail@priss.frightenedpiglet.com \
--to=sand@priss.frightenedpiglet.com \
--cc=emacs-pretest-bug@gnu.org \
/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).