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: Wed, 20 Dec 2006 08:00:51 -0500
Message-ID: <E1Gx13z-0000Nl-9B@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> <E1Gvflp-00048D-Hr@fencepost.gnu.org>
	<12d56hgh1q.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 1166620190 2623 80.91.229.10 (20 Dec 2006 13:09:50 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Wed, 20 Dec 2006 13:09:50 +0000 (UTC)
Cc: bug-gnu-emacs@gnu.org
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Dec 20 14:09:49 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 1Gx1CR-0004X3-WB
	for geb-bug-gnu-emacs@m.gmane.org; Wed, 20 Dec 2006 14:09:36 +0100
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1Gx1CR-0002RL-3C
	for geb-bug-gnu-emacs@m.gmane.org; Wed, 20 Dec 2006 08:09:35 -0500
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1Gx154-0004MD-LQ
	for bug-gnu-emacs@gnu.org; Wed, 20 Dec 2006 08:01:58 -0500
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1Gx152-0004KH-7t
	for bug-gnu-emacs@gnu.org; Wed, 20 Dec 2006 08:01:56 -0500
Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1Gx151-0004Jv-Nd
	for bug-gnu-emacs@gnu.org; Wed, 20 Dec 2006 08:01:55 -0500
Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org)
	by monty-python.gnu.org with esmtp (Exim 4.52) id 1Gx150-0007QW-F7
	for bug-gnu-emacs@gnu.org; Wed, 20 Dec 2006 08:01:54 -0500
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.60)
	(envelope-from <rms@gnu.org>)
	id 1Gx13z-0000Nl-9B; Wed, 20 Dec 2006 08:00:51 -0500
Original-To: "Ilya N. Golubev" <gin@mo.msk.ru>
In-reply-to: <12d56hgh1q.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:15475
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/15475>

    Part of the text in the documentation patch is about `comint.el' (and
    thus of concern to all of innumerable modes based on it).

Can you find a suitable doc string to put that in?

							       The other
    text is specifically about `shell.el'.

Can you find a suitable doc string to put that in?
Or a good place in shell.el?

    What will make maintainers read it before sending (unnecessary)
    questions to users?

People normally read the comments in the vicinity of the code they are
working on.