[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/modes.texi
From: |
Richard M . Stallman |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/modes.texi |
Date: |
Tue, 09 Aug 2005 08:09:15 -0400 |
Index: emacs/lispref/modes.texi
diff -c emacs/lispref/modes.texi:1.116 emacs/lispref/modes.texi:1.117
*** emacs/lispref/modes.texi:1.116 Wed Jul 27 15:30:42 2005
--- emacs/lispref/modes.texi Tue Aug 9 12:09:14 2005
***************
*** 1373,1379 ****
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}.
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
--- 1373,1380 ----
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}. 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
***************
*** 1423,1428 ****
--- 1424,1437 ----
@var{body} forms, if any. It finishes by running the mode hook
variable @address@hidden
@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
- [Emacs-diffs] Changes to emacs/lispref/modes.texi,
Richard M . Stallman <=