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:43:21 +0200 Message-ID: References: <20190114091307.f33jqe54syxtceeq@lenovo> <8736jergtr.fsf@mouse.gnus.org> <87bly23kfm.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="259489"; 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, Piotr Kaznowski To: Noam Postavsky Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jul 10 00:51:20 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 1hkyxD-0015Gn-TA for geb-bug-gnu-emacs@m.gmane.org; Wed, 10 Jul 2019 00:51:20 +0200 Original-Received: from localhost ([::1]:56624 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hkyqg-0006YE-So for geb-bug-gnu-emacs@m.gmane.org; Tue, 09 Jul 2019 18:44:34 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43101) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hkyqF-0006Y6-Ms for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:44:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hkyqB-0004G2-Sc for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:44:05 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53891) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hkyqA-0004FT-4N for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:44:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hkyq9-0007Sr-Tj for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:44:01 -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:44:01 +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.156271220628644 (code B ref 34073); Tue, 09 Jul 2019 22:44:01 +0000 Original-Received: (at 34073) by debbugs.gnu.org; 9 Jul 2019 22:43:26 +0000 Original-Received: from localhost ([127.0.0.1]:34479 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hkypZ-0007Rv-RS for submit@debbugs.gnu.org; Tue, 09 Jul 2019 18:43:26 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:55124) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hkypY-0007Ro-Rj for 34073@debbugs.gnu.org; Tue, 09 Jul 2019 18:43:25 -0400 Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=stories) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hkypV-0001fR-83; Wed, 10 Jul 2019 00:43:23 +0200 Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAD1BMVEW0VTa/ajuUOS7SmV8w Dw/Wzy+6AAACZUlEQVQ4jT1UgZXsIAgEvQJArwAlFqCxgfue/df0B5M9s+9t1hGYGXCJaRehQMRi ZEuVOBQOlSjt/RMlcCEJYUuwYkIlUf3ae6/JQlxKaAhyhANJ245ETUSadmjLdqFSqexn5T5I0sJb 2KhS6OsFVu7J0vMuBDZtf1YdnNpuey0BLwDrg1g5EWuBO1P6iwAQ9olwISR+5qli9oXXhogCzfop EtM2KyciBVLUf1nN1lYhgHuXJAnQA1yjrW1hV0IqdoNe6XkGZCmNGfuamPiRuOZ0EQZfwFa9OD+E r46IvUjgO7zHI3qA3wcwnFTkSTjxFPntdlIWxVGpgYLKUyR8AEG2iiaAwtn5tkeP84FVSJnDyXU/ JCBSGTHEXfgAcjf/bouTcA/E9e2uJWvHz4IIwlJVb8/+Ca29VUbwKcp0qx3X26e8E4ZXnB7xJ5UD 9TAGOSTF2eVA88B/NFgpc3R819nRCjylbZYKr1JCkJbpwLJVxfYPSoAuaHHOMw8zyzaH6JxgBbpI qHNMB7pNnJlzwC4YL8z+Q8o9q29jddjOVNV/Zv+cfc+FayIB3LAxfAuZp3DMgzrM5PHEi0s0TaFe CuV6ys0x3tnDRNbsxTsS35cz+QMyWEmHmSdR1oaGZ9y63X5w83iIYfuGQhfmLHxICRqCxZ4Hro2n mwdA53HxtsV6waqQ5zg8mt82pWYWLd93sxcYaOUzJZavWAJIvoDtytAxrc6rorEVVh5zfFIcEJ7l ynetDADV83f12ZEuc4Tfa0DEyCM6de2GCaU5WOI1K+vM/biDy+xTgv8KirErFGo81qPp/wFNRqEQ JAtLKwAAAABJRU5ErkJggg== In-Reply-To: <87bly23kfm.fsf@gmail.com> (Noam Postavsky's message of "Tue, 09 Jul 2019 18:35:57 -0400") 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:162569 Archived-At: Noam Postavsky writes: > Maybe define-minor-mode could mention this in the mode's docstring, like > it does for the ARG? It subtly alludes to this in this bit: -- BODY contains code to execute each time the mode is enabled or disabled. It is executed after toggling the mode, and before running MODE-hook. -- But that's not the documentation somebody who wonders when hooks are run would look -- that macro is for people who implement modes, not people who just wants to run some hooks... -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no