From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Richard Stallman <rms@gnu.org>
Newsgroups: gmane.emacs.bugs
Subject: Re: shell completion documentation
Date: Fri, 15 Dec 2006 16:24:46 -0500
Message-ID: <E1GvKXu-0001Z7-Nm@fencepost.gnu.org>
References: <16k64g20tu.fsf@mo.msk.ru> <E1GLRDD-0000mS-2D@fencepost.gnu.org>
	<59ejumjzz2.fsf@mo.msk.ru> <E1GLjTm-0000cp-DO@fencepost.gnu.org>
	<843bazvd1b.fsf@mo.msk.ru> <82odq9aswt.fsf@mo.msk.ru>
	<87slflasys.fsf@mo.msk.ru> <E1Guj9Y-0002Wp-IW@fencepost.gnu.org>
	<91mz5ql61p.fsf_-_@mo.msk.ru>
Reply-To: rms@gnu.org
NNTP-Posting-Host: dough.gmane.org
Content-Type: text/plain; charset=ISO-8859-15
X-Trace: sea.gmane.org 1166217999 19166 80.91.229.10 (15 Dec 2006 21:26:39 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Fri, 15 Dec 2006 21:26:39 +0000 (UTC)
Cc: bug-gnu-emacs@gnu.org
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Dec 15 22:26:38 2006
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
Envelope-to: geb-bug-gnu-emacs@m.gmane.org
Original-Received: from lists.gnu.org ([199.232.76.165])
	by dough.gmane.org with esmtp (Exim 4.50)
	id 1GvKZh-0002it-LF
	for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Dec 2006 22:26:37 +0100
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1GvKZg-0001fq-Uw
	for geb-bug-gnu-emacs@m.gmane.org; Fri, 15 Dec 2006 16:26:37 -0500
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1GvKXx-00008Z-2W
	for bug-gnu-emacs@gnu.org; Fri, 15 Dec 2006 16:24:49 -0500
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1GvKXw-000087-Ez
	for bug-gnu-emacs@gnu.org; Fri, 15 Dec 2006 16:24:48 -0500
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1GvKXw-00007y-BF
	for bug-gnu-emacs@gnu.org; Fri, 15 Dec 2006 16:24:48 -0500
Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.52) id 1GvKXw-0001v3-73
	for bug-gnu-emacs@gnu.org; Fri, 15 Dec 2006 16:24:48 -0500
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.52)
	id 1GvKXu-0001Z7-Nm; Fri, 15 Dec 2006 16:24:46 -0500
Original-To: "Ilya N. Golubev" <gin@mo.msk.ru>
In-reply-to: <91mz5ql61p.fsf_-_@mo.msk.ru> (gin@mo.msk.ru)
X-BeenThere: bug-gnu-emacs@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Bug reports for GNU Emacs,
	the Swiss army knife of text editors" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/bug-gnu-emacs>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Xref: news.gmane.org gmane.emacs.bugs:15464
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/15464>

    > This is too much detail, and too dense.

    That's the point.  Just as much as any <specific test case> for
    `comint-dynamic-complete' bug report.

Bug reports and manuals are not comparable.

    That is, requesting these details from *users* reporting bugs is ok,
    but for *maintainers* to document the same user visible details is
    unreasonable.

Absolutely.  To we debug a bug, we need the details; if they make the
bug report hard to read, we just have to roll up our sleeves and read
it anyway.

However, there is no obligation to make the manual so hard to read,
and it would be counterproductive to do so.