From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#34073: 26.1; Missing documentation for minor mode hook behavior Date: Wed, 10 Jul 2019 00:20:00 +0200 Message-ID: <8736jergtr.fsf@mouse.gnus.org> References: <20190114091307.f33jqe54syxtceeq@lenovo> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="139338"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 34073@debbugs.gnu.org To: Piotr Kaznowski Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jul 10 00:21:45 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hkyUa-000a5H-FM for geb-bug-gnu-emacs@m.gmane.org; Wed, 10 Jul 2019 00:21:44 +0200 Original-Received: from localhost ([::1]:56514 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hkyUY-0001qc-VE for geb-bug-gnu-emacs@m.gmane.org; Tue, 09 Jul 2019 18:21:42 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50803) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hkyUB-0001pa-82 for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:21:20 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hkyU8-0004jy-Tu for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:21:18 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53857) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hkyTx-0004f5-DV for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:21:11 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hkyTu-0004lA-8V for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:21:05 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 09 Jul 2019 22:21:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 34073 X-GNU-PR-Package: emacs Original-Received: via spool by 34073-submit@debbugs.gnu.org id=B34073.156271080818209 (code B ref 34073); Tue, 09 Jul 2019 22:21:02 +0000 Original-Received: (at 34073) by debbugs.gnu.org; 9 Jul 2019 22:20:08 +0000 Original-Received: from localhost ([127.0.0.1]:34445 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hkyT2-0004jd-6L for submit@debbugs.gnu.org; Tue, 09 Jul 2019 18:20:08 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:54748) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hkyT0-0004jV-JQ for 34073@debbugs.gnu.org; Tue, 09 Jul 2019 18:20:07 -0400 Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hkySv-0001TA-8y; Wed, 10 Jul 2019 00:20:03 +0200 In-Reply-To: <20190114091307.f33jqe54syxtceeq@lenovo> (Piotr Kaznowski's message of "Mon, 14 Jan 2019 10:13:08 +0100") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:162565 Archived-At: Piotr Kaznowski writes: > I couldn't find essential information about minor mode hooks behavior, > namely that "The minor mode's hook is called both when activating and > deactivating the minor mode" (as stated here: > https://emacs.stackexchange.com/a/47092/17425). > > It isn't mentioned in the manual (sections "Minor Modes" and "Hooks"), > nor in the docstring for `add-hook' function. Mentioning it `add-hook' is perhaps not natural, and I don't think it's 100% adhered to, anyway? Only by minor modes that are defined by define-minor-mode? Other minor modes may or may not call the hook. It is mentioned in the "Defining Minor Modes" node of the Lisp manual... but is probably not where people would be looking for this information. Hm. Perhaps `add-hook' is the right place to mention this anyway? But with caveats about, well, everything? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no