From: Richard M. Stallman <rms@gnu.org>
Date: Tue, 2 Jan 2007 20:57:30 +0000 (+0000)
Subject: (Defining Minor Modes): Explain effect of command
X-Git-Tag: emacs-pretest-22.0.93~288
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=14bafd7ea7daae51a55707a66c8ab27533033aad;p=emacs.git

(Defining Minor Modes): Explain effect of command
defined with define-global-minor-mode on new buffers.
---

diff --git a/lispref/modes.texi b/lispref/modes.texi
index 29c316d625d..c5fd0159ac2 100644
--- a/lispref/modes.texi
+++ b/lispref/modes.texi
@@ -1480,12 +1480,15 @@ See the command \\[hungry-electric-delete]."
 @end smallexample
 
 @defmac define-global-minor-mode global-mode mode turn-on keyword-args@dots{}
-This defines a global minor mode named @var{global-mode} whose meaning
-is to enable the buffer-local minor mode @var{mode} in every buffer.
-To turn on the minor mode in a buffer, it uses the function
+This defines a global toggle named @var{global-mode} whose meaning is
+to enable or disable the buffer-local minor mode @var{mode} in all
+buffers.  To turn on the minor mode in a buffer, it uses the function
 @var{turn-on}; to turn off the minor mode, it calls @code{mode} with
 @minus{}1 as argument.
 
+Globally enabling the mode also affects buffers subsequently created
+by visiting files, but not buffers subsequently created in other ways.
+
 Use @code{:group @var{group}} in @var{keyword-args} to specify the
 custom group for the mode variable of the global minor mode.
 @end defmac