; * doc/lispref/modes.texi (Defining Minor Modes): Explain TURN-ON.

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index ad46708f027aeedb283324501f2cefe994f7544b..72b4a6fb4f784c4e7f67bd6f7dcb85c4981b0e9c 100644 (file)
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -1839,7 +1839,9 @@ to enable or disable the buffer-local minor mode @var{mode} in all (or
 some; see below) buffers.  It also executes the @var{body} forms.  To
 turn on the minor mode in a buffer, it uses the function
 @var{turn-on}; to turn off the minor mode, it calls @var{mode} with
-@minus{}1 as argument.
+@minus{}1 as argument.  (The function @var{turn-on} is a separate
+function so it could determine whether to enable the minor mode or not
+when it is not a priori clear that it should always be enabled.)
 
 Globally enabling the mode also affects buffers subsequently created
 by visiting files, and buffers that use a major mode other than