From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#11326: 24.1.50; doc of `dired-recursive-copies', `dired-recursive-deletes' Date: Tue, 24 Apr 2012 09:37:59 -0700 Message-ID: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1335285571 31904 80.91.229.3 (24 Apr 2012 16:39:31 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 24 Apr 2012 16:39:31 +0000 (UTC) To: 11326@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Apr 24 18:39:29 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1SMim0-0007IA-5z for geb-bug-gnu-emacs@m.gmane.org; Tue, 24 Apr 2012 18:39:28 +0200 Original-Received: from localhost ([::1]:40695 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SMilz-0005sV-DQ for geb-bug-gnu-emacs@m.gmane.org; Tue, 24 Apr 2012 12:39:27 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:50989) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SMilt-0005rU-F3 for bug-gnu-emacs@gnu.org; Tue, 24 Apr 2012 12:39:25 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SMilo-0003Lz-36 for bug-gnu-emacs@gnu.org; Tue, 24 Apr 2012 12:39:21 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:49949) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SMiln-0003Lv-UE for bug-gnu-emacs@gnu.org; Tue, 24 Apr 2012 12:39:16 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SMimZ-0001oz-Bd for bug-gnu-emacs@gnu.org; Tue, 24 Apr 2012 12:40:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 24 Apr 2012 16:40:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 11326 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.13352855646928 (code B ref -1); Tue, 24 Apr 2012 16:40:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 24 Apr 2012 16:39:24 +0000 Original-Received: from localhost ([127.0.0.1]:50983 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SMilw-0001nf-1h for submit@debbugs.gnu.org; Tue, 24 Apr 2012 12:39:24 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:60416) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SMilt-0001nR-60 for submit@debbugs.gnu.org; Tue, 24 Apr 2012 12:39:21 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SMikx-0003Ge-AO for submit@debbugs.gnu.org; Tue, 24 Apr 2012 12:38:27 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:60307) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SMikx-0003Ga-6o for submit@debbugs.gnu.org; Tue, 24 Apr 2012 12:38:23 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:50800) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SMikv-0005gd-8O for bug-gnu-emacs@gnu.org; Tue, 24 Apr 2012 12:38:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SMikl-0003FS-TC for bug-gnu-emacs@gnu.org; Tue, 24 Apr 2012 12:38:20 -0400 Original-Received: from acsinet15.oracle.com ([141.146.126.227]:36699) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SMikl-0003F1-NA for bug-gnu-emacs@gnu.org; Tue, 24 Apr 2012 12:38:11 -0400 Original-Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q3OGc5WD002935 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 24 Apr 2012 16:38:06 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q3OGc4cK017844 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 24 Apr 2012 16:38:05 GMT Original-Received: from abhmt116.oracle.com (abhmt116.oracle.com [141.146.116.68]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q3OGc49r017619 for ; Tue, 24 Apr 2012 11:38:04 -0500 Original-Received: from dradamslap1 (/10.159.223.238) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 24 Apr 2012 09:38:04 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac0iOJwJdwDHhFyRR7C6cuAmUFKshQ== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet21.oracle.com [156.151.31.93] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.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-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:59453 Archived-At: The doc strings are incomprehensible, especially the one for *-copies. They do not explain what is meant by a "recursive copy" or a "recursive delete". A copy is a duplicate. What is a recursive copy? What is a "recursive delete"? The fault is to use "recursive" in combination with "copy/delete" as a noun instead of a verb. This is not about recursive objects (which is what nouns denote). It is about acting recursively. Recursive copying makes sense, and users can figure out what is meant by that term. A "recursive copy" makes no sense. Similarly "recursive delete" vs recursively deleting. (And FWIW there is no such thing as a "delete". The correct noun here is "deletion". A correct noun phrase is "delete operation". But not just "delete".) See the Emacs manual description for `dired-recursive-copies' - it makes sense: The variable `dired-recursive-copies' controls whether to copy directories recursively (like `cp -r'). The default is `top', which means to ask before recursively copying a directory. For `dired-recursive-deletes', the Emacs manual says this, which also makes sense: You can delete empty directories just like other files, but normally Dired cannot delete directories that are nonempty. If the variable `dired-recursive-deletes' is non-`nil', then Dired can delete nonempty directories including all their contents. That can be somewhat risky. The doc string for `dired-recursive-deletes' is slightly better than that for `dired-recursive-copies', because it at least mentions deleting recursively. But it still suffers from talking about "recursive deletes". Please look to the descriptions in the manual for guidance wrt these doc strings. In GNU Emacs 24.1.50.1 (i386-mingw-nt5.1.2600) of 2012-04-23 on MARVIN Bzr revision: 108006 agustin.martin@hispalinux.es-20120423103325-xmra3329elgzhmpc Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --enable-checking --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include -ID:/devel/emacs/libs/libiconv-1.13.1-1-dev/include -ID:/devel/emacs/libs/libxml2-2.7.8/include/libxml2'