diff options
Diffstat (limited to 'lispref/modes.texi')
| -rw-r--r-- | lispref/modes.texi | 21 |
1 files changed, 14 insertions, 7 deletions
diff --git a/lispref/modes.texi b/lispref/modes.texi index 053e7a511e8..49b05021d91 100644 --- a/lispref/modes.texi +++ b/lispref/modes.texi @@ -1,6 +1,6 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. -@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, +@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2002, @c 2003, 2004, 2005 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../info/modes @@ -869,9 +869,7 @@ command interpreter in a @samp{#!} line. Its value is an alist with elements of the form @code{(@var{interpreter} . @var{mode})}; for example, @code{("perl" . perl-mode)} is one element present by default. The element says to use mode @var{mode} if the file -specifies an interpreter which matches @var{interpreter}. The value -of @var{interpreter} is actually a regular expression. @xref{Regular -Expressions}. +specifies an interpreter which matches @var{interpreter}. @end defvar @defvar magic-mode-alist @@ -1373,7 +1371,8 @@ symbol). It defines a command named @var{mode} to toggle the minor mode, with @var{doc} as its documentation string. It also defines a variable named @var{mode}, which is set to @code{t} or @code{nil} by enabling or disabling the mode. The variable is initialized to -@var{init-value}. +@var{init-value}. Except in unusual circumstances (see below), this +value must be @code{nil}. The string @var{lighter} says what to display in the mode line when the mode is enabled; if it is @code{nil}, the mode is not displayed @@ -1424,6 +1423,14 @@ as setting the variable named @var{mode} and then executes the variable @code{@var{mode}-hook}. @end defmac + The initial value must be @code{nil} except in cases where (1) the +mode is preloaded in Emacs, or (2) it is painless to for loading to +enable the mode even though the user did not request it. For +instance, if the mode has no effect unless something else is enabled, +and will always be loaded by that time, enabling it by default is +harmless. But these are unusual circumstances. Normally, the +initial value must be @code{nil}. + @findex easy-mmode-define-minor-mode The name @code{easy-mmode-define-minor-mode} is an alias for this macro. @@ -1607,7 +1614,7 @@ value is a list, each element may be a list, a symbol, or a string. The mode line can display various faces, if the strings that control it have the @code{face} property. @xref{Properties in Mode}. In addition, the face @code{mode-line} is used as a default for the whole -mode line (@pxref{Standard Faces}). +mode line (@pxref{Standard Faces,,, emacs, The GNU Emacs Manual}). @table @code @cindex percent symbol in mode line @@ -1920,7 +1927,7 @@ function. @xref{Buffer File Name}. @item %F The title (only on a window system) or the name of the selected frame. -@xref{Window Frame Parameters}. +@xref{Basic Parameters}. @item %i The size of the accessible part of the current buffer; basically |