GNU bug report logs - #1947
23.0.60; Please document use of `dired' with an explicit file list

Previous Next

Package: emacs;

Reported by: "Drew Adams" <drew.adams <at> oracle.com>

Date: Sun, 18 Jan 2009 18:50:03 UTC

Severity: minor

Tags: wontfix

Done: Lars Magne Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

Full log

View this message in rfc822 format

From: Kevin Rodgers <kevin.d.rodgers <at> gmail.com>
To: bug-gnu-emacs <at> gnu.org
Cc: emacs-pretest-bug <at> gnu.org
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

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
This bug report was last modified 14 years and 13 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.