[Emacs-diffs] Changes to emacs/lispref/modes.texi

[Richard M . Stallman]

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