From debbugs-submit-bounces@debbugs.gnu.org Tue Feb 27 13:12:41 2018 Received: (at submit) by debbugs.gnu.org; 27 Feb 2018 18:12:41 +0000 Received: from localhost ([127.0.0.1]:35934 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eqjk1-0002x4-Fb for submit@debbugs.gnu.org; Tue, 27 Feb 2018 13:12:41 -0500 Received: from eggs.gnu.org ([208.118.235.92]:51730) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1eqjjz-0002ws-Ld for submit@debbugs.gnu.org; Tue, 27 Feb 2018 13:12:40 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eqjjt-0005gB-Nb for submit@debbugs.gnu.org; Tue, 27 Feb 2018 13:12:34 -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,T_DKIM_INVALID autolearn=disabled version=3.3.2 Received: from lists.gnu.org ([2001:4830:134:3::11]:47290) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eqjjt-0005g3-JC for submit@debbugs.gnu.org; Tue, 27 Feb 2018 13:12:33 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:42700) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eqjjs-0002FW-KT for bug-gnu-emacs@gnu.org; Tue, 27 Feb 2018 13:12:33 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eqjjn-0005bE-KT for bug-gnu-emacs@gnu.org; Tue, 27 Feb 2018 13:12:32 -0500 Received: from userp2120.oracle.com ([156.151.31.85]:48396) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eqjjn-0005aT-6H for bug-gnu-emacs@gnu.org; Tue, 27 Feb 2018 13:12:27 -0500 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w1RIBXRC187659 for ; Tue, 27 Feb 2018 18:12:20 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=OQl1hnV8PL9NpNxuSDpVje+WtvY9mUXH5jDrSwg3q+w=; b=tniuCNA4sucoQP9DMnw2RfFsdim+qsyNYbQ4DglnRRgeN5vPMM+i+zG7L5CYGChz1bIq r+QXyY0b3Wzg1ZPcOBPLZbZ4gJvk9TUxiGNStxueNBkyWK3yHd2bwApbyc/XGvPxpMZ5 +CItkU0dLADUhI3uK81dD4HKegMCQeglVH/k5Syx0t8rXtkO7grhtE7ekGPVC53Cg4El qh16zxCXd2X9zwmOBh0l1LxHoU0yyDuJhCg24O5d58c/FajzCPm8KUJGUktQ0E8i6ASu L+KvlwsPiXZ026kP048xQCoG2IZDw5Pa7yGAMmpkkNUx3U3KlYfsFq32VThvCDpKlzrW 1Q== Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp2120.oracle.com with ESMTP id 2gdbn109m4-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Tue, 27 Feb 2018 18:12:20 +0000 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 w1RICJcF013203 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL) for ; Tue, 27 Feb 2018 18:12:20 GMT Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w1RICJew014866 for ; Tue, 27 Feb 2018 18:12:19 GMT MIME-Version: 1.0 Message-ID: <87ca87d4-9cde-4250-a2bb-b5d22c2452f2@default> Date: Tue, 27 Feb 2018 10:12:18 -0800 (PST) From: Drew Adams To: bug-gnu-emacs@gnu.org Subject: 26.0; doc string of `dired-do-create-files' X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4654.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8817 signatures=668681 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=1 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=871 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1802270225 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] 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-Debbugs-Envelope-To: submit 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 (----) The doc string says this, where "into-dir" is the only occurrence of that text in the doc string: The rest of into-dir are optional arguments. This is incomprehensible. Yes, in the _code_ of the function there is an internal, local variable named `into-dir', but it makes no sense to refer to that in the doc string. --- (The entire description of arg HOW-TO is too complicated, particularly the "Otherwise" part. Apparently in this case HOW-TO is a function. If that function returns a non-nil list then its car is a function of 4 args... An example or two might help.) In GNU Emacs 26.0.91 (build 1, x86_64-w64-mingw32) of 2018-01-22 Repository revision: 752fba992b793a74d202c9cfc3e1a92fd458e748 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From debbugs-submit-bounces@debbugs.gnu.org Thu Mar 01 10:32:49 2018 Received: (at 30634-done) by debbugs.gnu.org; 1 Mar 2018 15:32:49 +0000 Received: from localhost ([127.0.0.1]:39460 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1erQCO-0002Zs-T2 for submit@debbugs.gnu.org; Thu, 01 Mar 2018 10:32:49 -0500 Received: from eggs.gnu.org ([208.118.235.92]:59610) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1erQCN-0002Zf-J5 for 30634-done@debbugs.gnu.org; Thu, 01 Mar 2018 10:32:47 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1erQCC-0004Jr-Is for 30634-done@debbugs.gnu.org; Thu, 01 Mar 2018 10:32:42 -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.0 required=5.0 tests=BAYES_40,T_RP_MATCHES_RCVD autolearn=disabled version=3.3.2 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:54742) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1erQCC-0004Jn-Ei; Thu, 01 Mar 2018 10:32:36 -0500 Received: from [176.228.60.248] (port=4676 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1erQCB-0000Hx-Eh; Thu, 01 Mar 2018 10:32:36 -0500 Date: Thu, 01 Mar 2018 17:32:45 +0200 Message-Id: <83fu5jyfoi.fsf@gnu.org> From: Eli Zaretskii To: Drew Adams In-reply-to: <87ca87d4-9cde-4250-a2bb-b5d22c2452f2@default> (message from Drew Adams on Tue, 27 Feb 2018 10:12:18 -0800 (PST)) Subject: Re: bug#30634: 26.0; doc string of `dired-do-create-files' References: <87ca87d4-9cde-4250-a2bb-b5d22c2452f2@default> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-Spam-Score: -5.0 (-----) X-Debbugs-Envelope-To: 30634-done Cc: 30634-done@debbugs.gnu.org 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: , Reply-To: Eli Zaretskii Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -5.0 (-----) > Date: Tue, 27 Feb 2018 10:12:18 -0800 (PST) > From: Drew Adams > > The doc string says this, where "into-dir" is the only occurrence of > that text in the doc string: > > The rest of into-dir are optional arguments. > > This is incomprehensible. Yes, in the _code_ of the function there is > an internal, local variable named `into-dir', but it makes no sense to > refer to that in the doc string. Thanks, fixed. > (The entire description of arg HOW-TO is too complicated, particularly > the "Otherwise" part. Apparently in this case HOW-TO is a function. If > that function returns a non-nil list then its car is a function of 4 > args... An example or two might help.) I didn't see it as overly complicated, I think it's very clear. From unknown Sat Jun 14 18:57:14 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Fri, 30 Mar 2018 11:24:04 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator