From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#25581: 25.1; Incorrect statement in (elisp) `Hooks' Date: Mon, 30 Jan 2017 08:51:20 -0800 (PST) Message-ID: <8e81acfe-ecaa-4fac-9484-24541b232ba1@default> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1485795206 22041 195.159.176.226 (30 Jan 2017 16:53:26 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 30 Jan 2017 16:53:26 +0000 (UTC) To: 25581@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jan 30 17:53:19 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cYFCa-0005Gq-OH for geb-bug-gnu-emacs@m.gmane.org; Mon, 30 Jan 2017 17:53:12 +0100 Original-Received: from localhost ([::1]:33803 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cYFCf-0003SK-BY for geb-bug-gnu-emacs@m.gmane.org; Mon, 30 Jan 2017 11:53:18 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59385) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cYFBV-0002gI-Pc for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2017 11:52:06 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cYFBS-0008RQ-MM for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2017 11:52:05 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:53126) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cYFBS-0008RM-If for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2017 11:52:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1cYFBS-0003Is-6E for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2017 11:52:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 30 Jan 2017 16:52:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 25581 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.148579509911738 (code B ref -1); Mon, 30 Jan 2017 16:52:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 30 Jan 2017 16:51:39 +0000 Original-Received: from localhost ([127.0.0.1]:51324 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cYFB5-00033F-9q for submit@debbugs.gnu.org; Mon, 30 Jan 2017 11:51:39 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:40083) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cYFB3-00032z-Lh for submit@debbugs.gnu.org; Mon, 30 Jan 2017 11:51:38 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cYFAx-0008MK-FL for submit@debbugs.gnu.org; Mon, 30 Jan 2017 11:51:32 -0500 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:50477) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cYFAx-0008MG-C3 for submit@debbugs.gnu.org; Mon, 30 Jan 2017 11:51:31 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59284) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cYFAw-0002SS-66 for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2017 11:51:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cYFAs-0008Kb-UI for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2017 11:51:30 -0500 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:27913) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cYFAs-0008Jr-Kd for bug-gnu-emacs@gnu.org; Mon, 30 Jan 2017 11:51:26 -0500 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id v0UGpNSg018380 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 30 Jan 2017 16:51:23 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.14.4/8.14.4) with ESMTP id v0UGpMiA030613 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Mon, 30 Jan 2017 16:51:22 GMT Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id v0UGpMMG018781 for ; Mon, 30 Jan 2017 16:51:22 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 12.0.6753.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: 208.118.235.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:128793 Archived-At: The second sentence here is incorrect: If the variable=E2=80=99s name ends in =E2=80=98-function=E2=80=99, then i= ts value is just a single function, not a list of functions. =E2=80=98add-hook=E2=80=99 cann= ot be used to modify such a _single function hook_, and you have to use =E2=80=98add-fun= ction=E2=80=99 instead (*note Advising Functions::). You CAN use `add-hook' to modify such a single-function hook. Nothing prevents you from doing so. And nothing even suggests that you should not. And you have always been able to do so. And this is the case whether or not the "single function hook" is intended to always be single-function (which intention AFAIK, is not enforced anywhere) or it is intended to have any number (including zero and one) of functions. See http://lists.gnu.org/archive/html/emacs-devel/2016-10/msg00448.html. See the other msgs of that thread also. At the very least, this text is misleading, in more than one way. In GNU Emacs 25.1.1 (x86_64-w64-mingw32) of 2016-09-17 built on LAPHROAIG Windowing system distributor 'Microsoft Corp.', version 6.1.7601 Configured using: 'configure --without-dbus --without-compress-install CFLAGS=3D-static'