Subject: RE: bug#1947: 23.0.60; Please document use of `dired' with an explicit file list

From: "Drew Adams" <[email-masked]>
Date: Sun, 10 Jul 2011 10:36:33 -0700

> > 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.