From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#34073: 26.1; Missing documentation for minor mode hook behavior Date: Tue, 09 Jul 2019 18:44:56 -0400 Message-ID: <877e8q3k0n.fsf@gmail.com> 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="259405"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.2.90 (gnu/linux) Cc: 34073@debbugs.gnu.org, Piotr Kaznowski To: Lars Ingebrigtsen 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 1hkyxB-0015Gn-7N for geb-bug-gnu-emacs@m.gmane.org; Wed, 10 Jul 2019 00:51:17 +0200 Original-Received: from localhost ([::1]:56650 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hkytW-0007to-B4 for geb-bug-gnu-emacs@m.gmane.org; Tue, 09 Jul 2019 18:47:30 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44686) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hkys8-0007Qf-99 for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:46:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hkys6-00063L-Od for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:46:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53898) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hkys5-00061g-R4 for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:46:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hkys5-0008Sr-NY for bug-gnu-emacs@gnu.org; Tue, 09 Jul 2019 18:46:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 09 Jul 2019 22:46: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.156271230629038 (code B ref 34073); Tue, 09 Jul 2019 22:46:01 +0000 Original-Received: (at 34073) by debbugs.gnu.org; 9 Jul 2019 22:45:06 +0000 Original-Received: from localhost ([127.0.0.1]:34486 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hkyrB-0007Xx-Og for submit@debbugs.gnu.org; Tue, 09 Jul 2019 18:45:06 -0400 Original-Received: from mail-io1-f45.google.com ([209.85.166.45]:33993) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hkyr9-0007U9-Fg for 34073@debbugs.gnu.org; Tue, 09 Jul 2019 18:45:04 -0400 Original-Received: by mail-io1-f45.google.com with SMTP id k8so561177iot.1 for <34073@debbugs.gnu.org>; Tue, 09 Jul 2019 15:45:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=2XPryN9olKuV08vMgQSUiI6A6YwkykBBDxCxFyli/ek=; b=a3JZh8RhAOMmyveZ1Eilnady+znluhXz0pnEZY1SJ2WNyJjrGOLmFc1Fke7Hy4MuR5 Pgtz8FTSpg+Vg609cOAEEPpWxLduDh7amW/+K6HgLVmo9q25yipZImWqguvOv+dcYp9x ivd6hcQFRajYZHgLTS6mp4Ms2xkJjlSvW7wA3Gmk9AkRfuLGvXlLRk++xteM4NfagIUG /HfvzjMl+oSivzt1Kqmru57WcHIVSnWmbu+qrofk+6M2d4IsMzklSyOx0/1vqLPU+8rv MyNoDARrhiMQYEA0tXwPUpmxSxEQapyswYZJlMc7OP9dP5UZBF+zORJVhYKqbQsH8GkC /Dhg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=2XPryN9olKuV08vMgQSUiI6A6YwkykBBDxCxFyli/ek=; b=ACbUjM2UKshymglKyuMXpl2am0UD97+gB51fb98fxL1CScMBGzpET0cC4ZFvX3KCRp wtRpOAHBIOYkHdXit/OMB4S6E5Tnl09uZXCAAY6RMGUvLRigk8J596jH9LYFFDVHmsSk WKDNzLcJgpJZEoCwF7ZbA3FqASTiDfm/P/XZyOutjzQq1fz+AdXSk9xNPZJgHKfGWGeh +aiWvOMYDERTZF3QdAEOxPyjzytmos81iHMTZL0/YOGAoWvGJoS9fTkb0+GvF+hiydEW qqg9GeKKguLypK43JnF0JjJw1Aiih4tOGK1++TZ+vNk64O4XxjbdtftHEcu0ejd5f52j 2Smg== X-Gm-Message-State: APjAAAX/POUKZrpU/uc0THcsqDPqOophpepoWpGUdj5cWTnY1PkMD7Gk Y/5Ej/jfJJNpnyToQu3jik0= X-Google-Smtp-Source: APXvYqyTIUpqrFjeouBf6JEdUwI78aMHFVQFHmh3xFzix9B5B7lW8mYF4IPOcx6z2/OzpRcp1DLFfg== X-Received: by 2002:a5d:8b52:: with SMTP id c18mr9191346iot.89.1562712297870; Tue, 09 Jul 2019 15:44:57 -0700 (PDT) Original-Received: from minid (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.gmail.com with ESMTPSA id i4sm264466iog.31.2019.07.09.15.44.57 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Tue, 09 Jul 2019 15:44:57 -0700 (PDT) In-Reply-To: (Lars Ingebrigtsen's message of "Wed, 10 Jul 2019 00:43:21 +0200") 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:162568 Archived-At: Lars Ingebrigtsen writes: > 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. > -- I didn't mean the docstring of define-minor-mode, I meant the docstring of the mode it defines.