From: Eli Zaretskii <eliz@gnu.org>
To: Drew Adams <drew.adams@oracle.com>
Cc: larsi@gnus.org, kevin.d.rodgers@gmail.com, 1947@debbugs.gnu.org
Subject: bug#1947: 23.0.60; Please document use of `dired' with an explicit file list
Date: Sun, 10 Jul 2011 20:47:42 +0300 [thread overview]
Message-ID: <8362nani2p.fsf@gnu.org> (raw)
In-Reply-To: <0D8BD9F7F323447A9E4083525EC00174@us.oracle.com>
> From: "Drew Adams" <drew.adams@oracle.com>
> Date: Sun, 10 Jul 2011 10:36:33 -0700
> Cc: 1947@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.
next prev parent reply other threads:[~2011-07-10 17:47 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2009-01-18 18:44 bug#1947: 23.0.60; Please document use of `dired' with an explicit file list Drew Adams
2009-01-20 3:20 ` Kevin Rodgers
2011-07-10 14:58 ` Lars Magne Ingebrigtsen
2011-07-10 17:36 ` Drew Adams
2011-07-10 17:47 ` Eli Zaretskii [this message]
2011-07-10 18:30 ` Drew Adams
2011-07-10 18:44 ` Eli Zaretskii
2011-07-10 20:07 ` Drew Adams
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.gnu.org/software/emacs/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=8362nani2p.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=1947@debbugs.gnu.org \
--cc=drew.adams@oracle.com \
--cc=kevin.d.rodgers@gmail.com \
--cc=larsi@gnus.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).