From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kevin Rodgers Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#1947: 23.0.60; Please document use of `dired' with an explicit file list Date: Mon, 19 Jan 2009 20:20:00 -0700 Message-ID: References: <007e01c9799c$d6bdecc0$0200a8c0@us.oracle.com> Reply-To: Kevin Rodgers , 1947@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1232423025 25487 80.91.229.12 (20 Jan 2009 03:43:45 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 20 Jan 2009 03:43:45 +0000 (UTC) Cc: emacs-pretest-bug@gnu.org To: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Jan 20 04:44:57 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LP7Xs-0001fU-T5 for geb-bug-gnu-emacs@m.gmane.org; Tue, 20 Jan 2009 04:44:57 +0100 Original-Received: from localhost ([127.0.0.1]:55078 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LP7Wa-0005GG-US for geb-bug-gnu-emacs@m.gmane.org; Mon, 19 Jan 2009 22:43:36 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LP7WW-0005Fn-Oi for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2009 22:43:32 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LP7WW-0005FW-2c for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2009 22:43:32 -0500 Original-Received: from [199.232.76.173] (port=36295 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LP7WV-0005FK-Fa for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2009 22:43:31 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:46484) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LP7WU-0005Ho-QT for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2009 22:43:31 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n0K3hR8r022193; Mon, 19 Jan 2009 19:43:28 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id n0K3P4Pw017511; Mon, 19 Jan 2009 19:25:04 -0800 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Kevin Rodgers Original-Sender: news Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Tue, 20 Jan 2009 03:25:04 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 1947 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.123242156916115 (code B ref -1); Tue, 20 Jan 2009 03:25:04 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 20 Jan 2009 03:19:29 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id n0K3JOeP016098 for ; Mon, 19 Jan 2009 19:19:26 -0800 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LP799-0004CL-Tx for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2009 22:19:23 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LP798-00049B-7A for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2009 22:19:23 -0500 Original-Received: from [199.232.76.173] (port=38125 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LP797-00048y-Su for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2009 22:19:21 -0500 Original-Received: from main.gmane.org ([80.91.229.2]:56768 helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LP797-000465-Gi for bug-gnu-emacs@gnu.org; Mon, 19 Jan 2009 22:19:21 -0500 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1LP796-00083W-0I for bug-gnu-emacs@gnu.org; Tue, 20 Jan 2009 03:19:20 +0000 Original-Received: from c-67-161-145-183.hsd1.co.comcast.net ([67.161.145.183]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 20 Jan 2009 03:19:19 +0000 Original-Received: from kevin.d.rodgers by c-67-161-145-183.hsd1.co.comcast.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 20 Jan 2009 03:19:19 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 23 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: c-67-161-145-183.hsd1.co.comcast.net User-Agent: Thunderbird 2.0.0.19 (Macintosh/20081209) In-Reply-To: <007e01c9799c$d6bdecc0$0200a8c0@us.oracle.com> X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Mon, 19 Jan 2009 22:43:32 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:24299 gmane.emacs.pretest.bugs:23723 Archived-At: Drew Adams wrote: > As far as I can tell, the use of `dired' with an explicit list of file > and directory names is undocumented (beyond the source code). It is > mentioned in neither the Emacs manual nor the Elisp manual. > > This is a useful feature - at least as useful as many of the other > Dired features that are documented. Questions about being able to > open Dired with an explicit list of files from different directories > are asked from time to time on help-gnu-emacs. > > The logical place to document this is in the Emacs manual, node `Dired > Enter'. That's so, even though to use this feature you must have a > list of file names. A simple example using `defvar' or `setq' to > define such a list would be sufficient - there are similar simple uses > of Emacs Lisp in the Emacs manual. 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. -- Kevin Rodgers Denver, Colorado, USA