From unknown Sun Jun 22 00:21:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#17566: 24.4.50; describe parameters in doc string: `dired-move-to-filename' etc. Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 23 May 2014 18:40:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 17566 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 17566@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.140087039728597 (code B ref -1); Fri, 23 May 2014 18:40:01 +0000 Received: (at submit) by debbugs.gnu.org; 23 May 2014 18:39:57 +0000 Received: from localhost ([127.0.0.1]:58174 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WnuNl-0007R5-DZ for submit@debbugs.gnu.org; Fri, 23 May 2014 14:39:57 -0400 Received: from eggs.gnu.org ([208.118.235.92]:47650) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WnuNd-0007Qe-Mm for submit@debbugs.gnu.org; Fri, 23 May 2014 14:39:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WnuNO-0002nh-01 for submit@debbugs.gnu.org; Fri, 23 May 2014 14:39:40 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:41651) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnuNN-0002nN-UN for submit@debbugs.gnu.org; Fri, 23 May 2014 14:39:29 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:49217) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnuNE-0006Ve-8j for bug-gnu-emacs@gnu.org; Fri, 23 May 2014 14:39:29 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WnuN0-0002db-Oz for bug-gnu-emacs@gnu.org; Fri, 23 May 2014 14:39:20 -0400 Received: from aserp1040.oracle.com ([141.146.126.69]:32427) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnuN0-0002dN-In for bug-gnu-emacs@gnu.org; Fri, 23 May 2014 14:39:06 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id s4NId4nv004298 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 23 May 2014 18:39:05 GMT Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231]) by ucsinet22.oracle.com (8.14.5+Sun/8.14.5) with ESMTP id s4NId3mp006342 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 23 May 2014 18:39:04 GMT Received: from abhmp0003.oracle.com (abhmp0003.oracle.com [141.146.116.9]) by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id s4NId3Qh027534 for ; Fri, 23 May 2014 18:39:03 GMT MIME-Version: 1.0 Message-ID: Date: Fri, 23 May 2014 11:39:01 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.8 (707110) [OL 12.0.6691.5000 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). 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.15 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 (----) Subject line says it all. Parameters should be described in doc strings! In the case of `dired-move-to-filename' it is not at all obvious what parameter RAISE-ERROR means, for example. Even the code comments seem to have trouble describing what RAISE-ERROR is for. In GNU Emacs 24.4.50.1 (i686-pc-mingw32) of 2014-05-17 on ODIEONE Bzr revision: 117119 eggert@cs.ucla.edu-20140517081131-ugu7ociaoec2xk7y Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --prefix=3D/c/Devel/emacs/snapshot/trunk --enable-checking=3Dyes,glyphs 'CFLAGS=3D-O0 -g3' LDFLAGS=3D-Lc:/Devel/emacs/lib 'CPPFLAGS=3D-DGC_MCHECK=3D1 -Ic:/Devel/emacs/include'' From unknown Sun Jun 22 00:21:17 2025 X-Loop: help-debbugs@gnu.org Subject: bug#17566: 24.4.50; describe parameters in doc string: `dired-move-to-filename' etc. Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 07 Oct 2019 17:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 17566 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 17566@debbugs.gnu.org Received: via spool by 17566-submit@debbugs.gnu.org id=B17566.157047028910398 (code B ref 17566); Mon, 07 Oct 2019 17:45:02 +0000 Received: (at 17566) by debbugs.gnu.org; 7 Oct 2019 17:44:49 +0000 Received: from localhost ([127.0.0.1]:49055 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHX3x-0002he-IT for submit@debbugs.gnu.org; Mon, 07 Oct 2019 13:44:49 -0400 Received: from quimby.gnus.org ([80.91.231.51]:42818) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHX3v-0002hU-Vt for 17566@debbugs.gnu.org; Mon, 07 Oct 2019 13:44:48 -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 1iHX3s-0006X1-Ns; Mon, 07 Oct 2019 19:44:47 +0200 From: Lars Ingebrigtsen References: Date: Mon, 07 Oct 2019 19:44:44 +0200 In-Reply-To: (Drew Adams's message of "Fri, 23 May 2014 11:39:01 -0700 (PDT)") Message-ID: <87k19g30xf.fsf@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: Drew Adams writes: > Subject line says it all. Parameters should be described in doc > strings! In the case of `dired-move-to-filename' it is not at all > obvious what parameter RAISE-ERROR means, for example. Even the [...] 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 (-) Drew Adams writes: > Subject line says it all. Parameters should be described in doc > strings! In the case of `dired-move-to-filename' it is not at all > obvious what parameter RAISE-ERROR means, for example. Even the code > comments seem to have trouble describing what RAISE-ERROR is for. I've now documented the parameters to that function in Emacs 27. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Mon Oct 07 13:44:55 2019 Received: (at control) by debbugs.gnu.org; 7 Oct 2019 17:44:55 +0000 Received: from localhost ([127.0.0.1]:49058 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHX42-0002hw-Ra for submit@debbugs.gnu.org; Mon, 07 Oct 2019 13:44:55 -0400 Received: from quimby.gnus.org ([80.91.231.51]:42832) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iHX41-0002hp-BT for control@debbugs.gnu.org; Mon, 07 Oct 2019 13:44:53 -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 1iHX3y-0006X8-M8 for control@debbugs.gnu.org; Mon, 07 Oct 2019 19:44:52 +0200 Date: Mon, 07 Oct 2019 19:44:50 +0200 Message-Id: <87imp030x9.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #17566 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 17566 fixed close 17566 27.1 quit 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 17566 fixed close 17566 27.1 quit