From: "Drew Adams" <drew.adams@oracle.com>
To: "'Eli Zaretskii'" <eliz@gnu.org>
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 11:30:59 -0700 [thread overview]
Message-ID: <67F360FF8E7F49E582A886209C30DC46@us.oracle.com> (raw)
In-Reply-To: <8362nani2p.fsf@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,
Irrelevant:
* No one said anything about what users are "supposed to do".
* No one argued that either doc strings or the manual is a substitute for the
other.
* No one said that everything that is mentioned in any doc string "necessarily"
needs to be described also in the manual.
Your arguments are facile, but you are arguing against a straw man.
It's about _this_ particular feature, whose description, in passing, in the
`dired' doc string has proven to be insufficient to make users aware of this
very useful feature.
> especially if it's an obscure feature used in special situations.
Not relevant here. This is a very useful, although relatively unknown, feature.
This feature is not obscure by its nature; it is simply not known well enough.
This bug report is about obviating some of that ignorance.
> 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.
Irrelevant; straw man. No one said the manual has "to tell everything".
Speak not in useless generalities, please. Speak to _this_ bug report; speak
about the documentation of _this_ Dired feature.
next prev parent reply other threads:[~2011-07-10 18:30 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
2011-07-10 18:30 ` Drew Adams [this message]
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=67F360FF8E7F49E582A886209C30DC46@us.oracle.com \
--to=drew.adams@oracle.com \
--cc=1947@debbugs.gnu.org \
--cc=eliz@gnu.org \
--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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.