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

Previous Next

Full log

View this message in rfc822 format

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Lars Magne Ingebrigtsen'" <larsi <at> gnus.org>, "'Kevin Rodgers'" <kevin.d.rodgers <at> gmail.com>
Cc: 1947 <at> debbugs.gnu.org
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

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

Previous Next

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