From: Eli Zaretskii <eliz@gnu.org>
Date: Wed, 19 Oct 2022 11:50:23 +0000 (+0300)
Subject: ; * doc/lispref/modes.texi (Defining Minor Modes): Explain TURN-ON.
X-Git-Tag: emacs-28.3-rc1~26
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=4b2c83eeaf25dc2e95b0265d2e3013ad0d16aa25;p=emacs.git

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

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index ad46708f027..72b4a6fb4f7 100644
--- 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