From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#72915: Docstrings of add-hook and remove-hook improvement? Date: Sun, 1 Sep 2024 00:18:38 -0700 Message-ID: References: <87v7zgrhrt.fsf@posteo.net> <86y14c9dk3.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="21248"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 72915@debbugs.gnu.org To: Eli Zaretskii , Tomas Nordin , Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sun Sep 01 09:20:15 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 1skesg-0005LZ-QV for geb-bug-gnu-emacs@m.gmane-mx.org; Sun, 01 Sep 2024 09:20:14 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1skesW-00058h-F2; Sun, 01 Sep 2024 03:20:04 -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 1skesV-00058X-5L for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2024 03:20:03 -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 1skesU-0007KL-Rp for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2024 03:20:02 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=Date:MIME-Version:References:In-Reply-To:From:To:Subject; bh=Wzw8Wk2Indpks14Bq4Vfo4R+Zv+tPPM0QrCDVMZT614=; b=kQqsNxKt7GQYbJ1nf6+dXz+O2XhhO/BP8BhRi7cUHodHhLKOmK5MrJCJ8N7JsfT7HBVke7rbE3qFzZDm6upoLBUeb3FC21DpBkC4/VAZL3+5OQRY90is28TpeJitt4Q6bkTEa6EekRr0alBVoOCwCjLLL8HLmd+o2w1XtCWeBmFJQQe+Wso4p2RaxLU2+TEZfDGSfoaGXoUWbYpbr4QYnOpsbHkUKJrq08jpqLk8eSN0Cso+LMff0Lwr6xHUM2t1r2w7esfGaTm5o1Wr3wTk7lwua5e3oGR2O3vzrWhg8sc7jItFFyYec/w3TK2sng7bCJhduMan6ifxONbMsnR8yQ==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1sketR-0005ad-QB for bug-gnu-emacs@gnu.org; Sun, 01 Sep 2024 03:21:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 01 Sep 2024 07:21:01 +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.172517524621446 (code B ref 72915); Sun, 01 Sep 2024 07:21:01 +0000 Original-Received: (at 72915) by debbugs.gnu.org; 1 Sep 2024 07:20:46 +0000 Original-Received: from localhost ([127.0.0.1]:32990 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sketC-0005Zq-0f for submit@debbugs.gnu.org; Sun, 01 Sep 2024 03:20:46 -0400 Original-Received: from mail-ed1-f53.google.com ([209.85.208.53]:60517) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1sket9-0005Za-Eq for 72915@debbugs.gnu.org; Sun, 01 Sep 2024 03:20:44 -0400 Original-Received: by mail-ed1-f53.google.com with SMTP id 4fb4d7f45d1cf-5c245c62362so813105a12.0 for <72915@debbugs.gnu.org>; Sun, 01 Sep 2024 00:19:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725175118; x=1725779918; darn=debbugs.gnu.org; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=Wzw8Wk2Indpks14Bq4Vfo4R+Zv+tPPM0QrCDVMZT614=; b=D4KF47A6rNfqpw0c1YodYC4BxBhpG6yeGa+qSyfsBygqTTRGKYm0omAydA5XGLBoHm CF7osppTyQwkai5EP8u3a0AlrDLIMsJsUJQZ0HtAYARaY5cEu2ztDM4o2Qir11x+PMip vILJKk3NwW08v3EnLp6h6omcTj/wH68gLtTbdmWlxtVm5mm7BXVFKqUilcDI81NZtz2V /eVIYcVtg8cwxsfi970KandB9o363q+UWcUgrGkpdPF90cWPpkYrHDnMVP1eMhgbgBfA lAFBVd7aRLyqjnGVYKOswWm8IxkxdIWPrUjVMqGXGLNRMqr0/mUFTXdjwbAUgJrnBJ3X Sp2g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725175118; x=1725779918; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=Wzw8Wk2Indpks14Bq4Vfo4R+Zv+tPPM0QrCDVMZT614=; b=etuz5uzZH0KqklQuijcgzefF17YCP4cD0/a6f1Vb91W9G3zI4Lg72FKGT72wfKPh3V U2OCTLCo+npTv0kJUrGsiVAV2+zQ6k64gAJII8G5BeJh2JSkUVvR3O/YL60hJ6xnv3cy Da0yvUKVYidzkm6n9kqEzAd7WJv7B/g67Qfw7bdQ/1E0zbMEqnNsw/jkiawD9iJk6McD h2ojE5BFzbLVNLtkb23QEwZzBc1CtSZpFmUYQGU0s25tzkr9zHfha/umzVQzSo13uEkw 9b9VN2FkgsNPXQwPje8YNmOdQF6fpuYmhsVzOO2OwBV27MvORBwI7epTYoLylffyULAT Bawg== X-Gm-Message-State: AOJu0YzQgpJXyJKHzkyHSeTBJMHcWCwc6Rzj2VkHfXufxDkK4zzMCEic BlxCNbDlV/wPXaJu5UK4sDswkKkepF6iFc5/iSGuwry0ltHV2MN+Yy4b9LaTFa8uK0M3A8gcGTT ta9hpHw++R1j6IA4e7S6ftOECPrzwSo+i X-Google-Smtp-Source: AGHT+IGg9pN/ZBWp4S/1vuFQqI8ZgsKQPKdlEXU9z2JK+hdkPBjo1PBXpyv5Y4VEmHmZCF4UbBw7P1pB+Uiq5+KjDpc= X-Received: by 2002:a05:6402:2690:b0:5bf:1301:84cd with SMTP id 4fb4d7f45d1cf-5c21ed41db7mr8777280a12.12.1725175118363; Sun, 01 Sep 2024 00:18:38 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 1 Sep 2024 00:18:38 -0700 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:291044 Archived-At: 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.