From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar Resent-From: Richard Copley Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 14 Feb 2017 21:23:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 25735@debbugs.gnu.org X-Debbugs-Original-To: "bug-gnu-emacs@gnu.org" Received: via spool by submit@debbugs.gnu.org id=B.14871073518867 (code B ref -1); Tue, 14 Feb 2017 21:23:01 +0000 Received: (at submit) by debbugs.gnu.org; 14 Feb 2017 21:22:31 +0000 Received: from localhost ([127.0.0.1]:40288 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cdkYR-0002Ix-CQ for submit@debbugs.gnu.org; Tue, 14 Feb 2017 16:22:31 -0500 Received: from eggs.gnu.org ([208.118.235.92]:55140) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1cdkYP-0002Ik-OU for submit@debbugs.gnu.org; Tue, 14 Feb 2017 16:22:30 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cdkYJ-00075r-8E for submit@debbugs.gnu.org; Tue, 14 Feb 2017 16:22:24 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=0.8 required=5.0 tests=BAYES_50,FREEMAIL_FROM, T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:53915) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cdkYJ-00075n-5C for submit@debbugs.gnu.org; Tue, 14 Feb 2017 16:22:23 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:46109) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cdkYH-0003NJ-R0 for bug-gnu-emacs@gnu.org; Tue, 14 Feb 2017 16:22:22 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cdkYG-00075Y-Pa for bug-gnu-emacs@gnu.org; Tue, 14 Feb 2017 16:22:21 -0500 Received: from mail-ua0-x22d.google.com ([2607:f8b0:400c:c08::22d]:33988) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1cdkYG-00074y-LR for bug-gnu-emacs@gnu.org; Tue, 14 Feb 2017 16:22:20 -0500 Received: by mail-ua0-x22d.google.com with SMTP id 35so94733288uak.1 for ; Tue, 14 Feb 2017 13:22:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=FcmIQabtooQmQwHHEkV150cxLHJcakbqcYl/ic2Wemo=; b=Jbbm3GbG4/Aof8DK03vEh6hNI6AXFmMlNhuLfGevQ9pqENnhZ1xEte26lYdmeLY+Dk dkleGCZ8F5702N00Wf6cg4RauJMm7wCd4H2xL+QAMiizJQ+ySf2OVtcRzs/S8Da+6kJT kEQjHcEvH05pPALlP+edvNoC4YeW5368X7LC6B7Kmo72cVOICuo4QmT7wLhLImDAHfwF AOdVTdXzL+/BpbYiM+trn7akSkTCnZFe8yEt1kTXgnFfQdMebwGMMAx7BrkbTc+B40XB 2xr/SnQsEHe+VZj5u4BVLg14retg+WQWZfgkYR3wXIjgG7ntscFMvx4aVIQK2puC3mf/ hROQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=FcmIQabtooQmQwHHEkV150cxLHJcakbqcYl/ic2Wemo=; b=V6WTv3s+VCoglDNxktyXqEYfYyk61HzjK60dX+VjOeCTznjYDzi8IC0Dr6SC7BLbgy a1eBSwfaHXkJBuDq+tlrXKrN887RO7I/b165vbsh3IMhw8m/UDvl5zcTXv/Hf4p089iF 068b5pK4Nu9vghGcF+MZZ8d2UZR3NuCTfnXEpcD7qXE2TnMt0xIyZ3vKCYEoRpJnk3wX mTpsU+ZExgf/qzjmjR5887I0qE9QAAGGro1XCGfOrY4ziRv9ApsIg7nu5hE0NbCcvyZZ X1+99YbMkl46xR8qtIPUJvRM154nc3DtAZhW0ASODAxl0+vhvxBlmoB7lUjzHqTLaFqq JAiw== X-Gm-Message-State: AMke39mudMX0WSg1yeEoSRGoccuSgWWMc7oM7+qYGjElbAa8L011AEzjGAzrqveJ5X1r+R1IVH9cdg2ug8mzcg== X-Received: by 10.159.49.66 with SMTP id n2mr16986551uab.72.1487107338332; Tue, 14 Feb 2017 13:22:18 -0800 (PST) MIME-Version: 1.0 Received: by 10.176.82.239 with HTTP; Tue, 14 Feb 2017 13:21:48 -0800 (PST) From: Richard Copley Date: Tue, 14 Feb 2017 21:21:48 +0000 Message-ID: Content-Type: text/plain; charset=UTF-8 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 2001:4830:134:3::11 X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -4.0 (----) Within the docstring for url-retrieve, it says: "[...] The error can be signaled with (signal ERROR-SYMBOL DATA) [...]", but in current master (grep for ":error" in "lisp/url/*.el") the actual usage is that ERROR-SYMBOL is `error' and DATA is a list that starts with a symbol, for example (connection-failed "failed with code 10061" :host "localhost" :service 80). The docstring hints at something like this: (url-retrieve (format "http://localhost/non-existent-resource") (lambda (status &rest args) (let ((error-info (plist-get status :error))) (when error-info (signal (car error-info) (cdr error-info)))) ;;... )) which ends up calling this: (signal 'error '(connection-failed "failed with code 10061" :host "localhost" :service 80)) which ends up printing these two lines (including the newline embedded in a string) to the echo area: error in process sentinel: peculiar error: "failed with code 10061 ", :host, "localhost", :service, 80 Unfortunately the error code itself, `connection-failed', is dropped. (See print_error_message in "print.c"; if ERROR-SYMBOL is `error' then the car of DATA, say ERRMSG, is printed if it is a string; if ERRMSG is not a string then "peculiar error" is printed instead of ERRMSG.) Please also consider augmenting the docstring with an example of using the error data. It's a drag for the user to have to work that out before they are in a position to call url-retrieve! (There's a tiny example above, but of course it assumes that DATA has been changed to conform to the docstring.) From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 15 May 2019 06:05:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Richard Copley Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.155790028324862 (code B ref 25735); Wed, 15 May 2019 06:05:02 +0000 Received: (at 25735) by debbugs.gnu.org; 15 May 2019 06:04:43 +0000 Received: from localhost ([127.0.0.1]:50790 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQn1u-0006Sv-RL for submit@debbugs.gnu.org; Wed, 15 May 2019 02:04:43 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:39476) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQn1t-0006Sn-Ca for 25735@debbugs.gnu.org; Wed, 15 May 2019 02:04:41 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1hQn1p-0004jN-7L; Wed, 15 May 2019 08:04:39 +0200 From: Lars Ingebrigtsen References: Date: Wed, 15 May 2019 08:04:31 +0200 In-Reply-To: (Richard Copley's message of "Tue, 14 Feb 2017 21:21:48 +0000") Message-ID: <87lfz8uuc0.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Richard Copley writes: > Within the docstring for url-retrieve, it says: "[...] The > error can be signaled with (signal ERROR-SYMBOL DATA) [...]", > but in current master (grep for ":error" in "lisp/url/*.el") the actual > usage is that ERROR-SYMBOL is `error' and DATA is a list that starts > with a symbol, for example (connection-failed "failed with code 10061" > :host "localhost" :service 80). The docstring hints at something > like this: > > (url-retrieve (format "http://localhost/non-existent-resource") > (lambda (status &rest args) > (let ((error-info (plist-get status :error))) > (when error-info > (signal (car error-info) (cdr error-info)))) > ;;... > )) I tried finding that doc string, but it doesn't seem to exist any more? Was that in the `url-retrieve' doc string? --- grep --color -nH --null -e "car error-info" `find . -type f` Grep finished with no matches found at Wed May 15 08:01:26 --- > which ends up calling this: > > (signal 'error > '(connection-failed "failed with code 10061" > :host "localhost" > :service 80)) > > which ends up printing these two lines (including the newline > embedded in a string) to the echo area: > > error in process sentinel: peculiar error: "failed with code 10061 > ", :host, "localhost", :service, 80 Yeah, that's not the right way to call `error'... > Unfortunately the error code itself, `connection-failed', is dropped. > (See print_error_message in "print.c"; if ERROR-SYMBOL is `error' then > the car of DATA, say ERRMSG, is printed if it is a string; if ERRMSG > is not a string then "peculiar error" is printed instead of ERRMSG.) > > Please also consider augmenting the docstring with an example of using > the error data. It's a drag for the user to have to work that out > before they are in a position to call url-retrieve! Yup. But I don't know why that example is gone -- perhaps somebody else remembers? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar Resent-From: Richard Copley Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 15 May 2019 07:03:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Lars Ingebrigtsen Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.155790375130154 (code B ref 25735); Wed, 15 May 2019 07:03:02 +0000 Received: (at 25735) by debbugs.gnu.org; 15 May 2019 07:02:31 +0000 Received: from localhost ([127.0.0.1]:50831 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQnvr-0007qI-Eo for submit@debbugs.gnu.org; Wed, 15 May 2019 03:02:31 -0400 Received: from mail-ot1-f41.google.com ([209.85.210.41]:38083) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQnvp-0007q5-D6 for 25735@debbugs.gnu.org; Wed, 15 May 2019 03:02:29 -0400 Received: by mail-ot1-f41.google.com with SMTP id s19so1292500otq.5 for <25735@debbugs.gnu.org>; Wed, 15 May 2019 00:02:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=Qu6eFaZIf/U00bUNMhDQLflwdRR/po43hxtI23pwVWw=; b=vYpEqOmvaM7Yi7fmvA16fVnmpbnAifY3lUTPe3m50HEbtLghMHSYgR+RySOGS/F1T8 4TjCvKsQhjaqcNRO3OevsY0eOa2JkMQoqpE2CF+iwuhBQQWxKOvGYOB1UDTwLLXTV/Fs cGSoNBeYvGm/ayhyFEiX5TnQm6dpL8lIwC1pQtIzcXZ/rmdw5+N61iuJNx7l0V+iQiSZ HPci0jj5jccw2VgULjSiySLd25UWhwBikHvk6ssbPQxT6tx4gth6JFM0f7rI/VTLzEm6 x3LYImVkQFE78oHi70jfaWP3uwoeDMIWdp6lDIo9CVOzOcqUO1G3MsVf3Ikk8gfEjGxq Tp/g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=Qu6eFaZIf/U00bUNMhDQLflwdRR/po43hxtI23pwVWw=; b=BuxD5Lft+p/h3+GwIdpPCqBuCjUe1agXumICLbJDTVNQ8uSQvfcFqk4TdCXm/nRIgO bSxHWz0nHyZAe6iriIculf2iIMiLVSVJ5VLH4OenjpnC5FeyY2atd6FZVkkEx/jCxPoQ boRn0YTSUAuAyo0l4bIS1RFfNwuv7pYjqgzyvlSWK7nHw1Lr8U+oVbqJ8K05zU+3DsCy jWUNTB14UIw96KkIXEiCwVhAYWtP4x19CEuaMg2NZ9DOLLqOgpSIqDsdsWwQ9xqKlmLi wXLAGF+la7lWsySOYKeAdBo2Bal+cOlbJquTKdQWQG5ydhSWaGUIAdAX2U5XWfp6EPHv XU0A== X-Gm-Message-State: APjAAAU0ymb87l8YRNnaIBW++1yEnwidh2skLTTe8GRT0OLsKybrwnFU NKNu7ulQmN9Mcq2lflIh3Twx8KGZ9HVexaqOo/Y= X-Google-Smtp-Source: APXvYqwfIUBA0J57K6KqxJFHUNL1jrSmztZhi6kvghL8bcYhl9jVY//rSxT7SWtIPDDCCeJRHWOVUSIXzbjY9JxdOrk= X-Received: by 2002:a9d:4d02:: with SMTP id n2mr11712otf.332.1557903743538; Wed, 15 May 2019 00:02:23 -0700 (PDT) MIME-Version: 1.0 References: <87lfz8uuc0.fsf@mouse.gnus.org> In-Reply-To: <87lfz8uuc0.fsf@mouse.gnus.org> From: Richard Copley Date: Wed, 15 May 2019 08:01:55 +0100 Message-ID: Content-Type: multipart/alternative; boundary="0000000000003a5b500588e7bbff" X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --0000000000003a5b500588e7bbff Content-Type: text/plain; charset="UTF-8" On Wed, 15 May 2019 at 07:04, Lars Ingebrigtsen wrote: > Richard Copley writes: > > > Within the docstring for url-retrieve, it says: "[...] The > > error can be signaled with (signal ERROR-SYMBOL DATA) [...]", > > but in current master (grep for ":error" in "lisp/url/*.el") the actual > > usage is that ERROR-SYMBOL is `error' and DATA is a list that starts > > with a symbol, for example (connection-failed "failed with code 10061" > > :host "localhost" :service 80). The docstring hints at something > > like this: > > > > (url-retrieve (format "http://localhost/non-existent-resource") > > (lambda (status &rest args) > > (let ((error-info (plist-get status :error))) > > (when error-info > > (signal (car error-info) (cdr error-info)))) > > ;;... > > )) > > I tried finding that doc string, but it doesn't seem to exist any more? > Was that in the `url-retrieve' doc string? > No, it's the best I could come up with given the "hint": "The error can be signaled with (signal ERROR-SYMBOL DATA)" in the url-retrieve docstring. > --- > grep --color -nH --null -e "car error-info" `find . -type f` > > Grep finished with no matches found at Wed May 15 08:01:26 > --- > > > > which ends up calling this: > > > > (signal 'error > > '(connection-failed "failed with code 10061" > > :host "localhost" > > :service 80)) > > > > which ends up printing these two lines (including the newline > > embedded in a string) to the echo area: > > > > error in process sentinel: peculiar error: "failed with code 10061 > > ", :host, "localhost", :service, 80 > > Yeah, that's not the right way to call `error'... > Yeah. > > Unfortunately the error code itself, `connection-failed', is dropped. > > (See print_error_message in "print.c"; if ERROR-SYMBOL is `error' then > > the car of DATA, say ERRMSG, is printed if it is a string; if ERRMSG > > is not a string then "peculiar error" is printed instead of ERRMSG.) > > > > Please also consider augmenting the docstring with an example of using > > the error data. It's a drag for the user to have to work that out > > before they are in a position to call url-retrieve! > > Yup. But I don't know why that example is gone -- perhaps somebody else > remembers? > > -- > (domestic pets only, the antidote for overdose, milk.) > bloggy blog: http://lars.ingebrigtsen.no > --0000000000003a5b500588e7bbff Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable


On = Wed, 15 May 2019 at 07:04, Lars Ingebrigtsen <larsi@gnus.org> wrote:
Richard Copley <rcopley@gmail.com> writes:

> Within the docstring for url-retrieve, it says: "[...] The
> error can be signaled with (signal ERROR-SYMBOL DATA) [...]",
> but in current master (grep for ":error" in "lisp/url/*= .el") the actual
> usage is that ERROR-SYMBOL is `error' and DATA is a list that star= ts
> with a symbol, for example (connection-failed "failed with code 1= 0061"
> :host "localhost" :service 80). The docstring hints at somet= hing
> like this:
>
>=C2=A0 =C2=A0(url-retrieve (format "http://localhost/= non-existent-resource")
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0(lambda (= status &rest args)
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0(l= et ((error-info (plist-get status :error)))
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0(when error-info
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0(signal (car error-info) (cdr error-info))))
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0;;= ...
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0))=

I tried finding that doc string, but it doesn't seem to exist any more?=
Was that in the `url-retrieve' doc string?

No, it's the best I could come up with given the "hint&quo= t;:
=C2=A0 "The error can be signaled with (signal ERROR= -SYMBOL DATA)"
in the url-retrieve docstring.
=
=C2=A0
---
grep --color -nH --null -e "car error-info" `find . -type f`

Grep finished with no matches found at Wed May 15 08:01:26
---


> which ends up calling this:
>
>=C2=A0 =C2=A0(signal 'error
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0'(connection-failed "= failed with code 10061"
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0:host "localhost&q= uot;
>=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0:service 80))
>
> which ends up printing these two lines (including the newline
> embedded in a string) to the echo area:
>
> error in process sentinel: peculiar error: "failed with code 1006= 1
> ", :host, "localhost", :service, 80

Yeah, that's not the right way to call `error'...
<= div>
Yeah.
=C2=A0
> Unfortunately the error code itself, `connection-failed', is dropp= ed.
> (See print_error_message in "print.c"; if ERROR-SYMBOL is `e= rror' then
> the car of DATA, say ERRMSG, is printed if it is a string; if ERRMSG > is not a string then "peculiar error" is printed instead of = ERRMSG.)
>
> Please also consider augmenting the docstring with an example of using=
> the error data. It's a drag for the user to have to work that out<= br> > before they are in a position to call url-retrieve!

Yup.=C2=A0 But I don't know why that example is gone -- perhaps somebod= y else
remembers?

--
(domestic pets only, the antidote for overdose, milk.)
=C2=A0 =C2=A0bloggy blog: http://lars.ingebrigtsen.no
--0000000000003a5b500588e7bbff-- From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 15 May 2019 07:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Richard Copley Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.155790460831540 (code B ref 25735); Wed, 15 May 2019 07:17:02 +0000 Received: (at 25735) by debbugs.gnu.org; 15 May 2019 07:16:48 +0000 Received: from localhost ([127.0.0.1]:50847 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQo9g-0008Cd-9Q for submit@debbugs.gnu.org; Wed, 15 May 2019 03:16:48 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:42340) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQo9e-0008CV-PP for 25735@debbugs.gnu.org; Wed, 15 May 2019 03:16:47 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1hQo9a-0006aO-Em; Wed, 15 May 2019 09:16:44 +0200 From: Lars Ingebrigtsen References: <87lfz8uuc0.fsf@mouse.gnus.org> Date: Wed, 15 May 2019 09:16:37 +0200 In-Reply-To: (Richard Copley's message of "Wed, 15 May 2019 08:01:55 +0100") Message-ID: <87ef50uqzu.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Richard Copley writes: > No, it's the best I could come up with given the "hint": > "The error can be signaled with (signal ERROR-SYMBOL DATA)" > in the url-retrieve docstring. Oh, I misread what you wrote. ---- (:redirect REDIRECTED-TO) - the request was redirected to this URL (:error (ERROR-SYMBOL . DATA)) - an error occurred. The error can be signaled with (signal ERROR-SYMBOL DATA). ---- So, yeah, that's wrong. It should be more like (signal ERROR-SYMBOL (format "%S" data)) I guess? But, as you say, that's not very useful, either. Describing DATA would be nicer. Here's the actual uses in url.el: url-http.el734: (nconc (list :error (list 'error 'http-redirect-limit url-http.el865: (nconc (list :error (list 'error 'http url-http-response-status)) url-http.el920: (nconc (list :error (list 'error 'http url-http-response-status)) url-http.el1446: (nconc (list :error (list 'error 'connection-failed why url-queue.el127: (when (and (eq (car status) :error) url-queue.el190: (cons (list :error (list 'error 'url-queue-timeout As we can see, the only ERROR-SYMBOL in use is `error', which makes this even less useful, and the DATA depends on what the real error type is... I guess we could just describe these in the doc string instead stop talking about `signal'? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar In-Reply-To: Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 15 May 2019 07:18:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Richard Copley Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.155790463931616 (code B ref 25735); Wed, 15 May 2019 07:18:01 +0000 Received: (at 25735) by debbugs.gnu.org; 15 May 2019 07:17:19 +0000 Received: from localhost ([127.0.0.1]:50851 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQoAA-0008Dq-Ry for submit@debbugs.gnu.org; Wed, 15 May 2019 03:17:19 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:42346) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQoA9-0008Di-5Q for 25735@debbugs.gnu.org; Wed, 15 May 2019 03:17:17 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1hQoA6-0000Bi-Dp; Wed, 15 May 2019 09:17:16 +0200 From: Lars Ingebrigtsen References: <87lfz8uuc0.fsf@mouse.gnus.org> Date: Wed, 15 May 2019 09:17:09 +0200 Message-ID: <87bm04uqyy.fsf@mouse.gnus.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Richard Copley writes: > No, it's the best I could come up with given the "hint": > "The error can be signaled with (signal ERROR-SYMBOL DATA)" > in the url-retrieve docstring. Oh, I misread what you wrote. ---- (:redirect REDIRECTED-TO) - the request was redirected to this URL (:error (ERROR-SYMBOL . DATA)) - an error occurred. The error can be signaled with (signal ERROR-SYMBOL DATA). ---- So, yeah, that's wrong. It should be more like (signal ERROR-SYMBOL (format "%S" data)) I guess? But, as you say, that's not very useful, either. Describing DATA would be nicer. Here's the actual uses in url.el: url-http.el 734: (nconc (list :error (list 'error 'http-redirect-limit url-http.el 865: (nconc (list :error (list 'error 'http url-http-response-status)) url-http.el 920: (nconc (list :error (list 'error 'http url-http-response-status)) url-http.el 1446: (nconc (list :error (list 'error 'connection-failed why url-queue.el 127: (when (and (eq (car status) :error) url-queue.el 190: (cons (list :error (list 'error 'url-queue-timeout As we can see, the only ERROR-SYMBOL in use is `error', which makes this even less useful, and the DATA depends on what the real error type is... I guess we could just describe these in the doc string instead stop talking about `signal'? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar In-Reply-To: Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 15 May 2019 07:20:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Richard Copley Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.155790476031807 (code B ref 25735); Wed, 15 May 2019 07:20:02 +0000 Received: (at 25735) by debbugs.gnu.org; 15 May 2019 07:19:20 +0000 Received: from localhost ([127.0.0.1]:50856 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQoC7-0008Gw-S6 for submit@debbugs.gnu.org; Wed, 15 May 2019 03:19:20 -0400 Received: from hermes.netfonds.no ([80.91.224.195]:42550) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQoC6-0008Go-5g for 25735@debbugs.gnu.org; Wed, 15 May 2019 03:19:18 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by hermes.netfonds.no with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1hQoC3-0006Fz-Ej; Wed, 15 May 2019 09:19:17 +0200 From: Lars Ingebrigtsen References: <87lfz8uuc0.fsf@mouse.gnus.org> Date: Wed, 15 May 2019 09:19:10 +0200 Message-ID: <87a7fouqvl.fsf@mouse.gnus.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Richard Copley writes: > No, it's the best I could come up with given the "hint": > "The error can be signaled with (signal ERROR-SYMBOL DATA)" > in the url-retrieve docstring. Oh, I misread what you wrote. ---- (:redirect REDIRECTED-TO) - the request was redirected to this URL (:error (ERROR-SYMBOL . DATA)) - an error occurred. The error can be signaled with (signal ERROR-SYMBOL DATA). ---- So, yeah, that's wrong. It should be more like (signal ERROR-SYMBOL (format "%S" data)) I guess? But, as you say, that's not very useful, either. Describing DATA would be nicer. Here's the actual uses in url.el: url-http.el 734: (nconc (list :error (list 'error 'http-redirect-limit url-http.el 865: (nconc (list :error (list 'error 'http url-http-response-status)) url-http.el 920: (nconc (list :error (list 'error 'http url-http-response-status)) url-http.el 1446: (nconc (list :error (list 'error 'connection-failed why url-queue.el 127: (when (and (eq (car status) :error) url-queue.el 190: (cons (list :error (list 'error 'url-queue-timeout As we can see, the only ERROR-SYMBOL in use is `error', which makes this even less useful, and the DATA depends on what the real error type is... I guess we could just describe these in the doc string instead stop talking about `signal'? -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 15 May 2019 07:47:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Richard Copley Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.15579063991858 (code B ref 25735); Wed, 15 May 2019 07:47:01 +0000 Received: (at 25735) by debbugs.gnu.org; 15 May 2019 07:46:39 +0000 Received: from localhost ([127.0.0.1]:50876 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQocZ-0000Tp-En for submit@debbugs.gnu.org; Wed, 15 May 2019 03:46:39 -0400 Received: from quimby.gnus.org ([80.91.231.51]:42040) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQocV-0000Td-Tn for 25735@debbugs.gnu.org; Wed, 15 May 2019 03:46:37 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hQocS-0001Zb-0c; Wed, 15 May 2019 09:46:34 +0200 From: Lars Ingebrigtsen References: <87lfz8uuc0.fsf@mouse.gnus.org> <87ef50uqzu.fsf@mouse.gnus.org> Date: Wed, 15 May 2019 09:46:31 +0200 In-Reply-To: <87ef50uqzu.fsf@mouse.gnus.org> (Lars Ingebrigtsen's message of "Wed, 15 May 2019 09:16:37 +0200") Message-ID: <87tvdwtb1k.fsf@mouse.gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: (Sorry for sending the previous email several times; I had some problems with the MTA...) I've now changed the doc string to --- Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) (Sorry for sending the previous email several times; I had some problems with the MTA...) I've now changed the doc string to --- \(:redirect REDIRECTED-TO) - the request was redirected to this URL. \(:error (error type . DATA)) - an error occurred. TYPE is a symbol that says something about where the error occurred, and DATA is a list (possibly nil) that describes the error further. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Wed May 15 03:46:41 2019 Received: (at control) by debbugs.gnu.org; 15 May 2019 07:46:41 +0000 Received: from localhost ([127.0.0.1]:50878 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQoca-0000U2-Oj for submit@debbugs.gnu.org; Wed, 15 May 2019 03:46:40 -0400 Received: from quimby.gnus.org ([80.91.231.51]:42054) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hQocZ-0000To-8m for control@debbugs.gnu.org; Wed, 15 May 2019 03:46:39 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hQocW-0001Zi-M3 for control@debbugs.gnu.org; Wed, 15 May 2019 09:46:38 +0200 Date: Wed, 15 May 2019 09:46:36 +0200 Message-Id: <87sgtgtb1f.fsf@mouse.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #25735 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: tags 25735 fixed close 25735 Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 25735 fixed close 25735 From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar Resent-From: Richard Copley Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 15 May 2019 21:01:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: Lars Ingebrigtsen Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.15579540286096 (code B ref 25735); Wed, 15 May 2019 21:01:02 +0000 Received: (at 25735) by debbugs.gnu.org; 15 May 2019 21:00:28 +0000 Received: from localhost ([127.0.0.1]:53498 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hR10l-0001aG-VU for submit@debbugs.gnu.org; Wed, 15 May 2019 17:00:28 -0400 Received: from mail-oi1-f173.google.com ([209.85.167.173]:43619) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hR10k-0001a1-1W for 25735@debbugs.gnu.org; Wed, 15 May 2019 17:00:26 -0400 Received: by mail-oi1-f173.google.com with SMTP id t187so846518oie.10 for <25735@debbugs.gnu.org>; Wed, 15 May 2019 14:00:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=2EmrvBdU152/NsjOG2MPaUyjJBbr6eUnwd3oBEku6Pg=; b=U5wLqIp8DNZTLoF+FQXTky3fSi+8mODREjtuQ46OE7lHM+W7aCh8TDrj4j53KyL4BS G+E+KxVZ2SRAZQTQ2+utn+BcyevAxdD4MKqQFzI+5nh5D6b2y2gV3EpGMU34Jn7dPUYw 8vzJw3JB+S16KsWOmVT78cCwE32ddyBwHlzq3jh94YqMJegs9AnVklPH1gtnwwhrrTC1 mIzm9dlqCXnhnbwaRINIs8v0xbB7vlR/TkefYR+mIHOiCy+KyxEofRMrAvBr1RwMp8pt yEl2hoRoP17SDII3GXSGK7aDl/WVl6R/gDJ7ROcEpbm/JgHzCKbT7eofSOXgVXXe4Qul 3x+Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=2EmrvBdU152/NsjOG2MPaUyjJBbr6eUnwd3oBEku6Pg=; b=jnQgo73EBKrVyIpYItpMy2i4f0ngCR8PeNFcqXjOaJ2nTV9XQrtIsusTS0I1Ofd0zv EuhDJhI3+peXA9Yue7524mpfA5EYbp5x+dkaJGqKIUReYtPAgZ0HsajGkRvCnWnXvXDK gq2S+7esrpf8xquWcH5aRfZY1RW1N8hmqxkvZLpP6+rGjW4tYKC68hnUD7rkJXMHGeIw +Rw1BKcQNcEDO5eHmqvSGkUoXp5QvOGuRGdGX6HnCU/T/vInnvgXRjUtXrl9TvYmx/BM /mYegZWw0z71fBF4yAUmpqbW5GEX0EVwh+Q//AxcWCnFJbqyCguqe4QCmitdwhoseEfz cCBA== X-Gm-Message-State: APjAAAWWX5pXdAgjd7vcbEzbOU0e/hpB//ngSKIMHIG0WfUx2wv51hty RNEYz0sMyLlKHXTvZS1lsrExOsfOZL5LOLyZGVw= X-Google-Smtp-Source: APXvYqw41ICl/ZQ+8A4isr0QlEo7J/Wnm+GkC/Gv/v5dbbungIT7bneEVuN/t2xFeRxiaxpjKFmI3/LH7aBMM3Hqm0o= X-Received: by 2002:aca:ef43:: with SMTP id n64mr8487712oih.79.1557954019941; Wed, 15 May 2019 14:00:19 -0700 (PDT) MIME-Version: 1.0 References: <87lfz8uuc0.fsf@mouse.gnus.org> <87ef50uqzu.fsf@mouse.gnus.org> <87tvdwtb1k.fsf@mouse.gnus.org> In-Reply-To: <87tvdwtb1k.fsf@mouse.gnus.org> From: Richard Copley Date: Wed, 15 May 2019 21:59:54 +0100 Message-ID: Content-Type: multipart/alternative; boundary="000000000000eff99d0588f36f1e" X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --000000000000eff99d0588f36f1e Content-Type: text/plain; charset="UTF-8" On Wed, 15 May 2019 at 08:46, Lars Ingebrigtsen wrote: > (Sorry for sending the previous email several times; I had some problems > with the MTA...) > > I've now changed the doc string to > > --- > > \(:redirect REDIRECTED-TO) - the request was redirected to this URL. > > \(:error (error type . DATA)) - an error occurred. TYPE is a > symbol that says something about where the error occurred, and > DATA is a list (possibly nil) that describes the error further. If there's a way to use that data to format an error message, it would be good to provide an example, or a "see info node X", if it's a common idiom. I think usually if you're looking at a docstring it's because you want to know how to use the function (as well as what it is for and what exactly it does, which I think are covered in this case). This is what I ended up with, after I reported the bug. Sadly I didn't make a note of where if anywhere I cribbed it from. (url-retrieve URL (lambda (status cbargs) (cl-loop for (key value) on status by 'cddr do (when (eq key :error) (error "%s: %s" (car value) (cdr value)))) BODY)) --000000000000eff99d0588f36f1e Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable

On Wed, 15 May 2019 at 08:46, = Lars Ingebrigtsen <larsi@gnus.org&= gt; wrote:
(Sorr= y for sending the previous email several times; I had some problems
with the MTA...)

I've now changed the doc string to

---

\(:redirect REDIRECTED-TO) - the request was redirected to this URL.

\(:error (error type . DATA)) - an error occurred.=C2=A0 TYPE is a
symbol that says something about where the error occurred, and
DATA is a list (possibly nil) that describes the error further.

If t= here's a way to use that data to format an error message,
it would be good to provide an example, or a "see i= nfo node X",
if it's a common idio= m.

I think usually if you're looking at a docstring it's because you<= /div>
want to know how to use the function (as we= ll as what it is for
and what exactly it do= es, which I think are covered in this case).

This is what I ended up with, after = I reported the bug.
Sadly I didn't make= a note of where if anywhere I cribbed it from.

(url-retrieve URL
=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2= =A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 (lambda (status cbargs)
=C2=A0= =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2= =A0=C2=A0 (cl-loop for (key value) on status by 'cddr
=C2=A0=C2=A0= =C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2= =A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 do (when (eq key = :error) (error "%s: %s" (car value) (cdr value))))
=C2=A0=C2= =A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0= =C2=A0 BODY))

--000000000000eff99d0588f36f1e-- From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 16 May 2019 04:00:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: Richard Copley Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.155797916328706 (code B ref 25735); Thu, 16 May 2019 04:00:02 +0000 Received: (at 25735) by debbugs.gnu.org; 16 May 2019 03:59:23 +0000 Received: from localhost ([127.0.0.1]:53944 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hR7YB-0007Sw-0w for submit@debbugs.gnu.org; Wed, 15 May 2019 23:59:23 -0400 Received: from quimby.gnus.org ([80.91.231.51]:56856) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hR7Y8-0007So-RI for 25735@debbugs.gnu.org; Wed, 15 May 2019 23:59:21 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=stories) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hR7Y5-0001pD-Ho; Thu, 16 May 2019 05:59:20 +0200 From: Lars Ingebrigtsen References: <87lfz8uuc0.fsf@mouse.gnus.org> <87ef50uqzu.fsf@mouse.gnus.org> <87tvdwtb1k.fsf@mouse.gnus.org> Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAFVBMVEWZmnUKBwcJBQYGAwMY FRAMCAkIBAUvGBrfAAACUElEQVQ4jWVUQW7jMAxkA6XnSrDvlbbRAxrAZzsr77kqrN4jF/z/E3ZG jpsWJZC04mgockhGCmxJ32wuJVvvhc6ylM1T6AxxPZ/PBOay+TYL3qmuKn35bTmXIn4BI1uYt9ne r8m1S+9OA82GGnCh+Rfx3RSiag0V3/gTvG88ACngDC9zGUAEDYjULv3TEOsKYD2TyXgb4xL5huoA ANFw8LaIXcCocIQ3g2D4ZwBirfRdSrockoqIUz4DkrdBKNQEZ8TnAjEGksko2WkdRRIAE9eh6lnx BoASwpNs9qB8Qwn0ZLgdOIx/mUe9Ad10kt3MIaBWCOwR6onx8YppCAqKwToyRjqmRWzjBG3pAigd z0fI+saMg3rnLIC+8Gwm6ADqgfJS+16sBcNkRPDLKI+12mYn8d6DMmUXfA/KBbU5ImCEN0Tq0V3G ulS7NVM8Qx1UY63aZGltBGPwL+20DoNWApCrMcIL6/hYqfcz825iAbBNqMfWB16xLm5vYFAoH7Vr BRVklG1G5QvvPXhcY9ozauuz8ydUToqx7ydKsg9xprplHsXMMiaGum3ERMZN380WQ/84YXxs3939 x52BgfPlG8F0dLdp99d+2b1gdGYHIuZ4HtMWf8l3hnLAsYtmlOBqaMCMXZKwvkatJzk8Gx3O+pLG cUzmCOAPN+ZTHrkgg34i17QBHCRwYuWcY6RuaygUCV3iSm2C78uJnjrOkrbdaCO1AVzl8O590Neq MV6/1rmgAe7rh8TsZRTBeqj++JWZWqxtvX6aMjNZf/nR/mtZ/gOKm+SrEvvIXQAAAABJRU5ErkJg gg== Date: Thu, 16 May 2019 05:59:17 +0200 In-Reply-To: (Richard Copley's message of "Wed, 15 May 2019 21:59:54 +0100") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Richard Copley writes: > If there's a way to use that data to format an error message, > it would be good to provide an example, or a "see info node X", > if it's a common idiom. > > I think usually if you're looking at a d [...] Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Richard Copley writes: > If there's a way to use that data to format an error message, > it would be good to provide an example, or a "see info node X", > if it's a common idiom. > > I think usually if you're looking at a docstring it's because you > want to know how to use the function (as well as what it is for > and what exactly it does, which I think are covered in this case). Well, I think we should assume that people know what arguments `error' takes, and the structure of the error data is now documented correctly. So I think that should be sufficient. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From unknown Sun Jun 22 03:55:27 2025 X-Loop: help-debbugs@gnu.org Subject: bug#25735: 26.0.50; url-retrieve errors are peculiar Resent-From: Richard Copley Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 16 May 2019 08:13:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 25735 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed To: Lars Ingebrigtsen Cc: 25735@debbugs.gnu.org Received: via spool by 25735-submit@debbugs.gnu.org id=B25735.155799432419931 (code B ref 25735); Thu, 16 May 2019 08:13:02 +0000 Received: (at 25735) by debbugs.gnu.org; 16 May 2019 08:12:04 +0000 Received: from localhost ([127.0.0.1]:54153 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hRBUi-0005BP-6H for submit@debbugs.gnu.org; Thu, 16 May 2019 04:12:04 -0400 Received: from mail-ot1-f41.google.com ([209.85.210.41]:33977) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hRBUf-0005Ar-LI for 25735@debbugs.gnu.org; Thu, 16 May 2019 04:12:02 -0400 Received: by mail-ot1-f41.google.com with SMTP id l17so2641859otq.1 for <25735@debbugs.gnu.org>; Thu, 16 May 2019 01:12:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=kHwmw28VrOLM0Ecv6c6evq2l2+0z3ZwBk351QWOAXEI=; b=EI9Pzfz5vNnc07+/UXLjDwJsJt2g+4yLEM69RpHz9YFwLwGBxVfr1OjRDlmucpio/G azQdrC0ISuIGwUrYDxApGtICZsr4z2Kmd1tRINzp271ZZ91RsZ1A93AXYXMifbf2AgXq d/URhpipVtBTtcYwWZz2ZoYniubRbH2HKqr4OPD5j8Ytk16HRXTPuQXMXw20hUz8y1Zf 71iHakyJdzNLjGJZ4qCc68eG5U1kqpGw0ucSUyzPo2v+RnF37yHqYh3Ht0M8IyFVza8u eeR26lNcWxSmRmDoFJ+7PDZi9qRJW6jRABXBUSSaTOvAcT4hfqzUvfLlqTaYkkFul9lS jGBA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=kHwmw28VrOLM0Ecv6c6evq2l2+0z3ZwBk351QWOAXEI=; b=ZLelTDs+WS+a5RA9gHdtNlTDzC01OSb7vzCGXV1Tb3H/DDjORLrgR9zqmPphJ4rOWZ FxdwaybE+FkGunzHE87RHX5N1pspkAXfN/G6jCIj8m9jFK+47SyHp3DVofUzU2tDg0IU olZefqstsuKZnDCgl0k68XRuWn/GT+ck8tkRW4m+w+foQhzf2AxCcjP1j3NVgvN7EIZD 1mynauaALZ7xLYHijkf4esOiOFDT0/AB+GgDsULSyqL6jmmi36CUuKQ7eInxvBRyW69U O0ta4LwFerTJAIOTYQmT63HqWml7076X55V3m5LPQG+3keDARWmmk0AiQNkdlfUMIGHg vPmA== X-Gm-Message-State: APjAAAWz2XZH4xay8n4EeG3SmL9iFusOVh5MmQ1c5XKF0cakq5/A7R76 vU+1IFZi7LEKqNUTlQsQkAu03cvc8zznHIkMPT0= X-Google-Smtp-Source: APXvYqwrvbtQy6bTgaooFpqD6rQ8lXv8ehjV2l7yToCXvIoBZQkOKHf1XmyHusBK2kA5KiBSPYApJ4fNlFzcAPtXPrU= X-Received: by 2002:a9d:5c0f:: with SMTP id o15mr8126251otk.47.1557994310875; Thu, 16 May 2019 01:11:50 -0700 (PDT) MIME-Version: 1.0 References: <87lfz8uuc0.fsf@mouse.gnus.org> <87ef50uqzu.fsf@mouse.gnus.org> <87tvdwtb1k.fsf@mouse.gnus.org> In-Reply-To: From: Richard Copley Date: Thu, 16 May 2019 09:11:24 +0100 Message-ID: Content-Type: multipart/alternative; boundary="000000000000763d8a0588fcd13c" X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) --000000000000763d8a0588fcd13c Content-Type: text/plain; charset="UTF-8" On Thu, 16 May 2019 at 04:59, Lars Ingebrigtsen wrote: > Richard Copley writes: > > > If there's a way to use that data to format an error message, > > it would be good to provide an example, or a "see info node X", > > if it's a common idiom. > > > > I think usually if you're looking at a docstring it's because you > > want to know how to use the function (as well as what it is for > > and what exactly it does, which I think are covered in this case). > > Well, I think we should assume that people know what arguments `error' > takes, and the structure of the error data is now documented correctly. > So I think that should be sufficient. > OK. It's (error STRING &rest ARGS), by the way. --000000000000763d8a0588fcd13c Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable


On Thu, 16 May 2019 at 04:59, Lars Ingebrigtsen <larsi@gnus.org> wrote:
Richard Copley <rcopley@gmail.com> writes:
> If there's a way to use that data to format an error message,
> it would be good to provide an example, or a "see info node X&quo= t;,
> if it's a common idiom.
>
> I think usually if you're looking at a docstring it's because = you
> want to know how to use the function (as well as what it is for
> and what exactly it does, which I think are covered in this case).

Well, I think we should assume that people know what arguments `error'<= br> takes, and the structure of the error data is now documented correctly.
So I think that should be sufficient.

O= K. It's (error STRING &rest ARGS), by the way.

--000000000000763d8a0588fcd13c--