Commit 9cf52b11 authored by Eli Zaretskii's avatar Eli Zaretskii

(Major Mode Conventions, Mode Line Variables): `mode-name' need not be a

string.  xref to "Mode Line Data" for details, and to "Emulating Mode Line"
for computing a string value.
parent 61ab9392
2008-10-15 Eli Zaretskii <eliz@gnu.org>
* modes.texi (Major Mode Conventions, Mode Line Variables):
`mode-name' need not be a string. xref to "Mode Line Data" for
details, and to "Emulating Mode Line" for computing a string
value.
2008-10-14 Eli Zaretskii <eliz@gnu.org> 2008-10-14 Eli Zaretskii <eliz@gnu.org>
* processes.texi (System Processes): New section. * processes.texi (System Processes): New section.
......
...@@ -317,8 +317,9 @@ which documentation to print. ...@@ -317,8 +317,9 @@ which documentation to print.
@item @item
The major mode command should set the variable @code{mode-name} to the The major mode command should set the variable @code{mode-name} to the
``pretty'' name of the mode, as a string. This string appears in the ``pretty'' name of the mode, usually a string (but see @ref{Mode Line
mode line. Data}, for other possible forms). The name of the mode appears
in the mode line.
@item @item
@cindex functions in modes @cindex functions in modes
...@@ -1865,8 +1866,12 @@ effect. ...@@ -1865,8 +1866,12 @@ effect.
@defvar mode-name @defvar mode-name
This buffer-local variable holds the ``pretty'' name of the current 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 buffer's major mode. Each major mode should set this variable so that
mode name will appear in the mode line. the mode name will appear in the mode line. The value does not have
to be a string, but can use any of the data types valid in a mode-line
construct (@pxref{Mode Line Data}). To compute the string that will
identify the mode name in the mode line, use @code{format-mode-line}
(@pxref{Emulating Mode Line}).
@end defvar @end defvar
@defvar mode-line-process @defvar mode-line-process
......
...@@ -1068,6 +1068,7 @@ checking/manipulating elements directly, use the new functions ...@@ -1068,6 +1068,7 @@ checking/manipulating elements directly, use the new functions
`byte-compile-warning-enabled-p', `byte-compile-disable-warning', and `byte-compile-warning-enabled-p', `byte-compile-disable-warning', and
`byte-compile-enable-warning.' `byte-compile-enable-warning.'
+++
** `mode-name' is no longer guaranteed to be a string. ** `mode-name' is no longer guaranteed to be a string.
Use `(format-mode-line mode-name)' to ensure a string value. Use `(format-mode-line mode-name)' to ensure a string value.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment