diff options
author | Richard M. Stallman <rms@gnu.org> | 2005-08-09 12:09:14 +0000 |
---|---|---|
committer | Richard M. Stallman <rms@gnu.org> | 2005-08-09 12:09:14 +0000 |
commit | d5ddc5473afa91f8e93dbf07851caeefdb6d6536 (patch) | |
tree | 0476b3475a92ff6eea387fd4f9fca32f03f975b3 /lispref | |
parent | 74620ee469049a02f843e8cdc4f0d733285a33db (diff) | |
download | emacs-d5ddc5473afa91f8e93dbf07851caeefdb6d6536.tar.gz |
(Defining Minor Modes): Explain when init-value can be non-nil.
Diffstat (limited to 'lispref')
-rw-r--r-- | lispref/modes.texi | 11 |
1 files changed, 10 insertions, 1 deletions
diff --git a/lispref/modes.texi b/lispref/modes.texi index 053e7a511e8..098a2d57068 100644 --- a/lispref/modes.texi +++ b/lispref/modes.texi @@ -1373,7 +1373,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 +1425,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. |