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 11:30:59 -0700 Message-ID: <67F360FF8E7F49E582A886209C30DC46@us.oracle.com> References: <007e01c9799c$d6bdecc0$0200a8c0@us.oracle.com> <0D8BD9F7F323447A9E4083525EC00174@us.oracle.com> <8362nani2p.fsf@gnu.org> 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 1310333201 21298 80.91.229.12 (10 Jul 2011 21:26:41 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 10 Jul 2011 21:26:41 +0000 (UTC) Cc: larsi@gnus.org, kevin.d.rodgers@gmail.com, 1947@debbugs.gnu.org To: "'Eli Zaretskii'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jul 10 23:26:36 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 1Qg1WM-0002L9-Fu for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Jul 2011 23:26:34 +0200 Original-Received: from localhost ([::1]:52859 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qg1WL-00033N-1U for geb-bug-gnu-emacs@m.gmane.org; Sun, 10 Jul 2011 17:26:33 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:36471) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QfynU-0000SC-OD for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 14:32:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QfynT-0001dx-Aa for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 14:32:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:45719) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QfynT-0001dp-1E for bug-gnu-emacs@gnu.org; Sun, 10 Jul 2011 14:32:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QfynS-000297-2y; Sun, 10 Jul 2011 14:32: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 18:32: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.13103226868203 (code B ref 1947); Sun, 10 Jul 2011 18:32:02 +0000 Original-Received: (at 1947) by debbugs.gnu.org; 10 Jul 2011 18:31:26 +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 1Qfymr-00028G-EQ for submit@debbugs.gnu.org; Sun, 10 Jul 2011 14:31:25 -0400 Original-Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qfymp-00027s-DB for 1947@debbugs.gnu.org; Sun, 10 Jul 2011 14:31:24 -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 p6AIVFvZ004096 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 10 Jul 2011 18:31:17 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 p6AIVErx015227 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Sun, 10 Jul 2011 18:31:15 GMT Original-Received: from abhmt117.oracle.com (abhmt117.oracle.com [141.146.116.69]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6AIV9RL030405; Sun, 10 Jul 2011 13:31:09 -0500 Original-Received: from dradamslap1 (/10.159.32.168) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 10 Jul 2011 11:31:08 -0700 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <8362nani2p.fsf@gnu.org> Thread-Index: Acw/KU8WXRXWaTXiQtGfWk7rARAk5wABJcoQ 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.0A090209.4E19EFF5.0098: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 14:32: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:48510 Archived-At: > > This is something that ordinary users should be made aware > > of. Simply mentioning it in the doc string of `dired' is > > not sufficient. > > I disagree. Users are supposed to read _both_ doc strings and the > manual. Therefore, something mentioned in the doc string does not > necessarily has to be described in the manual as well, Irrelevant: * No one said anything about what users are "supposed to do". * No one argued that either doc strings or the manual is a substitute for the other. * No one said that everything that is mentioned in any doc string "necessarily" needs to be described also in the manual. Your arguments are facile, but you are arguing against a straw man. It's about _this_ particular feature, whose description, in passing, in the `dired' doc string has proven to be insufficient to make users aware of this very useful feature. > especially if it's an obscure feature used in special situations. Not relevant here. This is a very useful, although relatively unknown, feature. This feature is not obscure by its nature; it is simply not known well enough. This bug report is about obviating some of that ignorance. > The manual is for describing things better, in more easily readable > form, without restrictions of doc string format. But it doesn't have > to tell everything. Irrelevant; straw man. No one said the manual has "to tell everything". Speak not in useless generalities, please. Speak to _this_ bug report; speak about the documentation of _this_ Dired feature.