Document locally disabling globalized minor modes in the lispref

* doc/lispref/modes.texi (Defining Minor Modes):
Mention disabling global minor modes on a per-major-mode basis.

* etc/NEWS: Clarify entry.

2 files changed, 12 insertions, 0 deletions

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index e2ea774fd48..6a8b7750f0b 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2012-02-01  Glenn Morris  <rgm@gnu.org>
+
+        * modes.texi (Defining Minor Modes):
+        Mention disabling global minor modes on a per-major-mode basis.
+
 2012-01-31  Chong Yidong  <cyd@gnu.org>
 
         * syntax.texi (Parsing Expressions): Clarify intro (Bug#10657).
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 5536006ecbe..6f99ddc3972 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -1521,8 +1521,15 @@ starts, for example by providing a @code{:require} keyword.
 
 Use @code{:group @var{group}} in @var{keyword-args} to specify the
 custom group for the mode variable of the global minor mode.
+
+When you define a globalized minor mode, you should generally also
+define a non-globalized version to toggle the mode on an individual
+buffer basis.  This allows users to disable a globally enabled minor
+mode in a specific major mode if they wish, by deactivating the local
+minor mode in the major mode's hook.
 @end defmac
 
+
 @node Mode Line Format
 @section Mode-Line Format
 @cindex mode line