GNU logs - #77609, boring messages

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#77609: How to add multiple functions to one hook with :hook in use-package?
Resent-From: Reuben Thomas <rrt@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Mon, 07 Apr 2025 13:46:02 +0000
Resent-Message-ID: <handler.77609.B.174403350726294 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 77609 <at> debbugs.gnu.org
MIME-Version: 1.0
From: Reuben Thomas <rrt@HIDDEN>
Date: Mon, 7 Apr 2025 14:43:39 +0100
Message-ID: <CAOnWdojXQF6HwXfF8prLKuV3Y-VdpghUsFR8HMxENaJo0AKUtw@HIDDEN>
Content-Type: multipart/alternative; boundary="0000000000002ccae80632306d82"
Received-SPF: pass client-ip=2607:f8b0:4864:20::1134;
 envelope-from=rrt@HIDDEN; helo=mail-yw1-x1134.google.com
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001,
 RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.9 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.1 (/)

--0000000000002ccae80632306d82
Content-Type: text/plain; charset="UTF-8"

The manual says:

The @code{:hook} keyword allows adding functions to hooks.  It takes
@c FIXME: The actual forms accepted by :hook are different, see below!
one argument of the form @var{hooks}, specifying one or more functions
to add to one or more hooks.

The FIXME suggests that the documentation may be incorrect!

I am precisely trying to add multiple functions to one hook, and I can't
work out how to do it with a single :hook clause. Is this in fact possible?
The most obvious syntax, copying the syntax for adding a function to
multiple hooks, does not work, e.g.:

(use-package foo-mode
  :hook
  (foo-mode . (function-a function-b)))

I tried other things, and searching online, and even looking at the source
code for use-package, but I can't work it out. Hence, maybe a good chance
to fix this FIXME in the docs, and explain to users how this is done, or
state that it cannot be done, and you have to use another method to add
multiple functions to a hook.

I have to say, use-package (which I have only now looked at) is a
revelation!

-- 
https://rrt.sc3d.org

--0000000000002ccae80632306d82
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div><div style=3D"font-family:arial,helvetica,sans-serif;=
font-size:small" class=3D"gmail_default">The manual says:</div><div style=
=3D"font-family:arial,helvetica,sans-serif;font-size:small" class=3D"gmail_=
default"><br></div><blockquote style=3D"margin:0px 0px 0px 0.8ex;border-lef=
t:1px solid rgb(204,204,204);padding-left:1ex" class=3D"gmail_default gmail=
_quote">The @code{:hook} keyword allows adding functions to hooks.=C2=A0 It=
 takes<br>@c FIXME: The actual forms accepted by :hook are different, see b=
elow!<br>one argument of the form @var{hooks}, specifying one or more funct=
ions<br>to add to one or more hooks. </blockquote><br clear=3D"all"></div><=
div><div style=3D"font-family:arial,helvetica,sans-serif;font-size:small" c=
lass=3D"gmail_default">The FIXME suggests that the documentation may be inc=
orrect!</div><div style=3D"font-family:arial,helvetica,sans-serif;font-size=
:small" class=3D"gmail_default"><br></div><div style=3D"font-family:arial,h=
elvetica,sans-serif;font-size:small" class=3D"gmail_default">I am precisely=
 trying to add multiple functions to one hook, and I can&#39;t work out how=
 to do it with a single :hook clause. Is this in fact possible? The most ob=
vious syntax, copying the syntax for adding a function to multiple hooks, d=
oes not work, e.g.:</div><div style=3D"font-family:arial,helvetica,sans-ser=
if;font-size:small" class=3D"gmail_default"><br></div><div style=3D"font-fa=
mily:arial,helvetica,sans-serif;font-size:small" class=3D"gmail_default">(u=
se-package foo-mode</div><div style=3D"font-family:arial,helvetica,sans-ser=
if;font-size:small" class=3D"gmail_default">=C2=A0 :hook</div><div style=3D=
"font-family:arial,helvetica,sans-serif;font-size:small" class=3D"gmail_def=
ault">=C2=A0 (foo-mode . (function-a function-b)))<br></div></div><div><br>=
</div><div><div style=3D"font-family:arial,helvetica,sans-serif;font-size:s=
mall" class=3D"gmail_default">I tried other things, and searching online, a=
nd even looking at the source code for use-package, but I can&#39;t work it=
 out. Hence, maybe a good chance to fix this FIXME in the docs, and explain=
 to users how this is done, or state that it cannot be done, and you have t=
o use another method to add multiple functions to a hook.</div><div style=
=3D"font-family:arial,helvetica,sans-serif;font-size:small" class=3D"gmail_=
default"><br></div><div style=3D"font-family:arial,helvetica,sans-serif;fon=
t-size:small" class=3D"gmail_default">I have to say, use-package (which I h=
ave only now looked at) is a revelation!<br></div></div><div><br></div><spa=
n class=3D"gmail_signature_prefix">-- </span><br><div dir=3D"ltr" class=3D"=
gmail_signature" data-smartmail=3D"gmail_signature"><div dir=3D"ltr"><div><=
div dir=3D"ltr"><a href=3D"https://rrt.sc3d.org" target=3D"_blank">https://=
rrt.sc3d.org</a></div></div></div></div></div>

--0000000000002ccae80632306d82--

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Reuben Thomas <rrt@HIDDEN>
Subject: bug#77609: Acknowledgement (How to add multiple functions to one
 hook with :hook in use-package?)
Message-ID: <handler.77609.B.174403350726294.ack <at> debbugs.gnu.org>
References: <CAOnWdojXQF6HwXfF8prLKuV3Y-VdpghUsFR8HMxENaJo0AKUtw@HIDDEN>
X-Gnu-PR-Message: ack 77609
X-Gnu-PR-Package: emacs
Reply-To: 77609 <at> debbugs.gnu.org
Date: Mon, 07 Apr 2025 13:46:03 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-gnu-emacs@HIDDEN

If you wish to submit further information on this problem, please
send it to 77609 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
77609: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D77609
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-gnu-emacs@HIDDEN:

Subject: bug#77609: How to add multiple functions to one hook with :hook in use-package?
Resent-From: Reuben Thomas <rrt@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Mon, 07 Apr 2025 13:48:01 +0000
Resent-Message-ID: <handler.77609.B.17440336445423 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 77609 <at> debbugs.gnu.org
MIME-Version: 1.0
References: <CAOnWdojXQF6HwXfF8prLKuV3Y-VdpghUsFR8HMxENaJo0AKUtw@HIDDEN>
In-Reply-To: <CAOnWdojXQF6HwXfF8prLKuV3Y-VdpghUsFR8HMxENaJo0AKUtw@HIDDEN>
From: Reuben Thomas <rrt@HIDDEN>
Date: Mon, 7 Apr 2025 14:46:59 +0100
Message-ID: <CAOnWdogfkwTVF9te2UJq+gPEv++oUqfRQi4SVKxEmYiD_RWS8g@HIDDEN>
Content-Type: multipart/alternative; boundary="0000000000000f45c20632307918"
Received-SPF: pass client-ip=2607:f8b0:4864:20::b2a; envelope-from=rrt@HIDDEN;
 helo=mail-yb1-xb2a.google.com
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001,
 RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.9 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.1 (/)

--0000000000000f45c20632307918
Content-Type: text/plain; charset="UTF-8"

On Mon, 7 Apr 2025 at 14:43, Reuben Thomas <rrt@HIDDEN> wrote:

>
> I tried other things, and searching online, and even looking at the source
> code for use-package, but I can't work it out.
>

I had another look at the source code, and found this:

           (concat label " a <symbol> or (<symbol or list of symbols> .
<symbol or function>)"
                   " or list of these")

It's unfortunate that this is part of an error message, as I've never seen
the error, but I think this explains the syntax, and indeed says that you
can't add multiple functions to a single hook with one :hook line; in other
words, it would be necessary to write something like:

(use-package foo-mode
   :hook
   ((foo-mode . function-a)
   (foo-mode . function-b)))

-- 
https://rrt.sc3d.org

--0000000000000f45c20632307918
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div class=3D"gmail_default" style=3D"fon=
t-family:arial,helvetica,sans-serif;font-size:small">On Mon, 7 Apr 2025 at =
14:43, Reuben Thomas &lt;<a href=3D"mailto:rrt@HIDDEN">rrt@HIDDEN</a>&g=
t; wrote:</div></div><div class=3D"gmail_quote gmail_quote_container"><bloc=
kquote class=3D"gmail_quote" style=3D"margin:0px 0px 0px 0.8ex;border-left:=
1px solid rgb(204,204,204);padding-left:1ex"><div dir=3D"ltr"><br><div><div=
 style=3D"font-family:arial,helvetica,sans-serif;font-size:small">I tried o=
ther things, and searching online, and even looking at the source code for =
use-package, but I can&#39;t work it out.</div></div></div></blockquote><di=
v><br></div><div><div style=3D"font-family:arial,helvetica,sans-serif;font-=
size:small" class=3D"gmail_default">I had another look at the source code, =
and found this:</div><div style=3D"font-family:arial,helvetica,sans-serif;f=
ont-size:small" class=3D"gmail_default"><br></div><div style=3D"font-family=
:arial,helvetica,sans-serif;font-size:small" class=3D"gmail_default">=C2=A0=
 =C2=A0 =C2=A0 =C2=A0 =C2=A0=C2=A0 (concat label &quot; a &lt;symbol&gt; or=
 (&lt;symbol or list of symbols&gt; . &lt;symbol or function&gt;)&quot;<br>=
=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0&quot;=
 or list of these&quot;)</div></div><div><br></div><div><div style=3D"font-=
family:arial,helvetica,sans-serif;font-size:small" class=3D"gmail_default">=
It&#39;s unfortunate that this is part of an error message, as I&#39;ve nev=
er seen the error, but I think this explains the syntax, and indeed says th=
at you can&#39;t add multiple functions to a single hook with one :hook lin=
e; in other words, it would be necessary to write something like:</div><div=
 style=3D"font-family:arial,helvetica,sans-serif;font-size:small" class=3D"=
gmail_default"><br></div><div style=3D"font-family:arial,helvetica,sans-ser=
if;font-size:small" class=3D"gmail_default">(use-package foo-mode</div><div=
 style=3D"font-family:arial,helvetica,sans-serif;font-size:small" class=3D"=
gmail_default">=C2=A0=C2=A0 :hook</div><div style=3D"font-family:arial,helv=
etica,sans-serif;font-size:small" class=3D"gmail_default">=C2=A0=C2=A0 ((fo=
o-mode . function-a)</div><div style=3D"font-family:arial,helvetica,sans-se=
rif;font-size:small" class=3D"gmail_default">=C2=A0=C2=A0 (foo-mode . funct=
ion-b)))<br></div></div><div>=C2=A0</div></div><span class=3D"gmail_signatu=
re_prefix">-- </span><br><div dir=3D"ltr" class=3D"gmail_signature"><div di=
r=3D"ltr"><div><div dir=3D"ltr"><a href=3D"https://rrt.sc3d.org" target=3D"=
_blank">https://rrt.sc3d.org</a></div></div></div></div></div>

--0000000000000f45c20632307918--

Last modified: Mon, 7 Apr 2025 14:00:03 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.