From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Tomas Nordin Newsgroups: gmane.emacs.bugs Subject: bug#72915: Docstrings of add-hook and remove-hook improvement? Date: Sun, 01 Sep 2024 15:47:36 +0000 Message-ID: <87plpnqstj.fsf@posteo.net> References: <87v7zgrhrt.fsf@posteo.net> <86y14c9dk3.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="3673"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 72915@debbugs.gnu.org To: Stefan Kangas , Eli Zaretskii , Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Sep 01 17:48:27 2024 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1skmoU-0000pu-Tl for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 01 Sep 2024 17:48:27 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1skmo9-0003KG-W1; Sun, 01 Sep 2024 11:48:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1skmo8-0003JV-3e for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2024 11:48:04 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1skmo7-00088r-R3 for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2024 11:48:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=vAZOI5yYPLAt5xWdlczUJQxy4YmvI/5B0c2VmSXh5Bw=; b=fBwH87NeNDKRn0dM5xzXm9QurUHk3WdvmHeUrRg7hwtaygoKpi5JB31oTqx72ogvJmDMKfXa2EkGMmDCIvh9A6vzCC1UEZDCMgcga7/dfAd3S/susYP+EG8S+9umk13f4/x+zyeleLTWR6+w3jcRm3avdbdMWqYMndHVjMPJ5cLnLq3cqgP68Wi64oE28irl4h9GPF43gbjvlIOjWUOUTTr8UyxRcXbGid2j8N1CGbR8/gyg7O1UOVwMq27ioT3l8Ek4qS8wRJgjO+Nmk9rT6lNchlnusWPup1K2Sd6Zt+at83p5kBosJRPA8mgL/kfqnl5CP3W3bHCSe4IR+ElZkA==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1skmp5-0004K7-EA for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2024 11:49:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Tomas Nordin Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 01 Sep 2024 15:49:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72915 X-GNU-PR-Package: emacs Original-Received: via spool by 72915-submit@debbugs.gnu.org id=B72915.172520572816573 (code B ref 72915); Sun, 01 Sep 2024 15:49:03 +0000 Original-Received: (at 72915) by debbugs.gnu.org; 1 Sep 2024 15:48:48 +0000 Original-Received: from localhost ([127.0.0.1]:37203 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1skmoq-0004JF-80 for submit@debbugs.gnu.org; Sun, 01 Sep 2024 11:48:48 -0400 Original-Received: from mout01.posteo.de ([185.67.36.65]:53311) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1skmom-0004Ix-TI for 72915@debbugs.gnu.org; Sun, 01 Sep 2024 11:48:46 -0400 Original-Received: from submission (posteo.de [185.67.36.169]) by mout01.posteo.de (Postfix) with ESMTPS id 2196124002B for <72915@debbugs.gnu.org>; Sun, 1 Sep 2024 17:47:38 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1725205658; bh=w4tDUeQWAsHuUpIHhwQEsCbqObpMrscRLd3Gx9+tz+Y=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type: From; b=M1w+idBnEqXJRgX3L9rMyg9Se93BDAzopbzS2J2D2R5gfpfs9EKQg4Zvn9xLqXEd4 htOXNXNUmE/GvPArNE5BK/1OQ9FV4aVMRAnYGEU3AC/lV7J4MP4lFe6vqPD+N1W/9G OJpNJmyZPGTCNYHa09bvbxXei8gy29bAtvVatzTmVSA/IDYn9YIU/UlFWWBa1uMFtH 7m+FFTgrr8s9nFbfJfIpEap0R0aY+xXRrGKR4jvMv/2mnsiY1xBIaornErgjimU/wE xP12rcLMbH2JxUP6Uyd8PTPZg3INeqYeRsCLu8kqoi/sLM+Mtd6IIuCi0RQlqpMOYB MjMO4CoYxJGfA== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4Wxbqs0k6zz6tsb; Sun, 1 Sep 2024 17:47:37 +0200 (CEST) In-Reply-To: X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list 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-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:291061 Archived-At: Stefan Kangas writes: > Stefan Kangas writes: > >> The wording in the manual is probably all that is needed here: >> >> This function removes FUNCTION from the hook variable HOOK. > > BTW. Here's another idea: > > If HOOK is a list of functions, remove FUNCTION from that list. > > If HOOK is equal to FUNCTION, set HOOK to nil. > > Otherwise do nothing. I like that, adjusted maybe to respect Stefan M's nitpick: If HOOK's value is a list of functions, remove FUNCTION from that list. If HOOK's value is FUNCTION, set HOOK to nil. Otherwise do nothing.