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#1947: 23.0.60; Please document use of `dired' with an explicit file list Date: Sun, 10 Jul 2011 10:36:33 -0700 Message-ID: <0D8BD9F7F323447A9E4083525EC00174@us.oracle.com> References: <007e01c9799c$d6bdecc0$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1310319455 9004 80.91.229.12 (10 Jul 2011 17:37:35 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 10 Jul 2011 17:37:35 +0000 (UTC) Cc: 1947@debbugs.gnu.org To: "'Lars Magne Ingebrigtsen'" , "'Kevin Rodgers'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 10 19:37:24 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QfxwZ-0007ZZ-QO for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Jul 2011 19:37:23 +0200 Original-Received: from localhost ([::1]:50192 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QfxwZ-0001i3-2J for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Jul 2011 13:37:23 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:45350) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QfxwG-0001ht-Tz for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 13:37:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QfxwF-0003B1-NA for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 13:37:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:35764) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QfxwF-0003Au-KH for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 13:37:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QfxwE-0008IZ-Lh; Sun, 10 Jul 2011 13:37:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 10 Jul 2011 17:37:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 1947 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: wontfix Original-Received: via spool by 1947-submit@debbugs.gnu.org id=B1947.131031941831887 (code B ref 1947); Sun, 10 Jul 2011 17:37:02 +0000 Original-Received: (at 1947) by debbugs.gnu.org; 10 Jul 2011 17:36:58 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QfxwA-0008IG-HN for submit@debbugs.gnu.org; Sun, 10 Jul 2011 13:36:58 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qfxw9-0008I5-Qm for 1947@debbugs.gnu.org; Sun, 10 Jul 2011 13:36:58 -0400 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6AHaoaU001010 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 Jul 2011 17:36:51 GMT Original-Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6AHanrl012782 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 10 Jul 2011 17:36:49 GMT Original-Received: from abhmt103.oracle.com (abhmt103.oracle.com [141.146.116.55]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6AHahUL009260; Sun, 10 Jul 2011 12:36:43 -0500 Original-Received: from dradamslap1 (/10.159.32.168) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 10 Jul 2011 10:36:43 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Acw/Efe5GElOMamNQd6G+kINZlabjQAFUy3w X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090205.4E19E334.001A:SCFMA922111,ss=1,re=-4.000,fgs=0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 10 Jul 2011 13:37:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:48493 Archived-At: > > It is explained in dired's doc string. Since the only way > > to use this feature is via Lisp (not M-x), I think the Emacs Lisp > > manual would be a better place to document it. > > However, the Emacs Lisp manual doesn't document dired at all, > so I think the current solution is best -- leave the > documentation in the doc string of the `dired' command. No, that does not address the bug report at all. The goal should be to improve Emacs for users, not simply to close bugs willy nilly without addressing them. This should be documented in the _Emacs_ manual. Not everything that requires a little Emacs Lisp is relegated to the Elisp manual. This is something that ordinary users should be made aware of. Simply mentioning it in the doc string of `dired' is not sufficient. Time has proven this to be the case. Although this is a very useful and very easy to use feature, few users are aware of it.