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#29838: 26.0; Elisp manual: describe standard-error sexps Date: Sun, 24 Dec 2017 10:50:16 -0800 (PST) Message-ID: References: <837etcj95f.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-2022-jp Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1514141361 9180 195.159.176.226 (24 Dec 2017 18:49:21 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sun, 24 Dec 2017 18:49:21 +0000 (UTC) Cc: 29838@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Dec 24 19:49:17 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 1eTBKl-0001ob-Ir for geb-bug-gnu-emacs@m.gmane.org; Sun, 24 Dec 2017 19:49:15 +0100 Original-Received: from localhost ([::1]:35122 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eTBMi-0007CO-Mm for geb-bug-gnu-emacs@m.gmane.org; Sun, 24 Dec 2017 13:51:16 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60474) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eTBMd-0007Bz-4A for bug-gnu-emacs@gnu.org; Sun, 24 Dec 2017 13:51:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eTBMY-0001Fi-4s for bug-gnu-emacs@gnu.org; Sun, 24 Dec 2017 13:51:11 -0500 Original-Received: from debbugs.gnu.org ([208.118.235.43]:42233) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eTBMY-0001E8-0r for bug-gnu-emacs@gnu.org; Sun, 24 Dec 2017 13:51:06 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eTBMU-0005bi-EP for bug-gnu-emacs@gnu.org; Sun, 24 Dec 2017 13:51: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: Sun, 24 Dec 2017 18:51:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 29838 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 29838-submit@debbugs.gnu.org id=B29838.151414143121509 (code B ref 29838); Sun, 24 Dec 2017 18:51:02 +0000 Original-Received: (at 29838) by debbugs.gnu.org; 24 Dec 2017 18:50:31 +0000 Original-Received: from localhost ([127.0.0.1]:50914 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eTBLz-0005ar-CX for submit@debbugs.gnu.org; Sun, 24 Dec 2017 13:50:31 -0500 Original-Received: from userp2130.oracle.com ([156.151.31.86]:49990) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eTBLx-0005ac-8P for 29838@debbugs.gnu.org; Sun, 24 Dec 2017 13:50:30 -0500 Original-Received: from pps.filterd (userp2130.oracle.com [127.0.0.1]) by userp2130.oracle.com (8.16.0.21/8.16.0.21) with SMTP id vBOIoKJG169618; Sun, 24 Dec 2017 18:50:20 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=jczsi9kxwMtZ6ZC5OB49RZeXBVpXI/rApyQWUWNQd9Y=; b=NYEZYQsyG3sOJeMezXn2fhimZ6XUEyAXDpl7vltXGRqK0Sq3BX9hCRtniHbYa9VdnhO6 f4IyoJjgkJCnUd2uLtUjSTE69T82OSUL0L+daLvueuhBnVXKtNJ3dwk/XT6+vN4K/dF9 cZ57pKf3JILCvXBKDu/pym9aFrF7B0R3fZ7AeMxM5IrlY5Hk/11qlpwBwSrNfLFJgy64 ravWUNmpBZSv2xBP9mdUylTI0EPBtCkoLxoJhKcIZe97jbQPFZ0CgsLe74i4UhMsRMfY lcsoOfpNYGGBUzZy7H1Ot4wFL8m6xEiDLxwyxIjlEXUpXsO+VeCVjmo1kTe4fv+UxTDj 4g== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp2130.oracle.com with ESMTP id 2f2hsmr03x-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sun, 24 Dec 2017 18:50:20 +0000 Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id vBOIoIs9013065 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sun, 24 Dec 2017 18:50:19 GMT Original-Received: from abhmp0008.oracle.com (abhmp0008.oracle.com [141.146.116.14]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id vBOIoH64032018; Sun, 24 Dec 2017 18:50:17 GMT In-Reply-To: <837etcj95f.fsf@gnu.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4627.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8755 signatures=668650 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=443 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1712240258 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:141460 Archived-At: > > Looking at the manual coverage of sequence etc. functions, you find > > information such as this: > > (elt [1 2 3 4] -1) > > error=1B$B"*=1B(B Args out of range: [1 2 3 4], -1 > > But that doesn't help for understanding `(args-out-of-range 9 9)'. >=20 > Not sure what you want to explain and how. The number of arguments > shown by the args-out-of-range error is not fixed (although in many > cases they are just 2), and their number and meaning are determined by > the calling application. It's not something fixed that can be > described to match all the uses. Please explain whatever _can_ be explained. Clearly, if the number and specific meanings of arguments cannot be known generically then that info cannot be conveyed. But so far, nothing at all is told users about a sexp such as `(args-out-of-range 9 9)'. A start could to be to mention that an `args-out-of range' error sexp has the form `(args-out-of-range ARG...)' or whatever the truth is, and then say what ARG represents, in general terms. The error messages themselves (see above) are quite different. They show you the sequence/array/whatever as well as the args that are out of range for it. (And a user would naturally expect, I think, that the info in something like `(args-out-of-range 9 9)' would provide the range that the args are outside of, as well as the arg values that are outside that range, even if it didn't provide the sequence/array/etc.)