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

Previous Next

Full log

Message #27 received at 1947 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: larsi <at> gnus.org, kevin.d.rodgers <at> gmail.com, 1947 <at> debbugs.gnu.org
Subject: Re: bug#1947: 23.0.60;
	Please document use of `dired' with an explicit file list
Date: Sun, 10 Jul 2011 20:47:42 +0300

> From: "Drew Adams" <drew.adams <at> oracle.com>
> Date: Sun, 10 Jul 2011 10:36:33 -0700
> Cc: 1947 <at> debbugs.gnu.org
> 
> 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, especially if
it's an obscure feature used in special situations.

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.

Previous Next

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