From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: Re: shell completion documentation Date: Sat, 16 Dec 2006 15:04:33 -0500 Message-ID: References: <16k64g20tu.fsf@mo.msk.ru> <59ejumjzz2.fsf@mo.msk.ru> <843bazvd1b.fsf@mo.msk.ru> <82odq9aswt.fsf@mo.msk.ru> <87slflasys.fsf@mo.msk.ru> <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 1166299482 9009 80.91.229.10 (16 Dec 2006 20:04:42 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 16 Dec 2006 20:04:42 +0000 (UTC) Cc: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Dec 16 21:04:40 2006 Return-path: 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 1Gvflv-0008Bw-Rx for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Dec 2006 21:04:40 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gvflv-0001qY-Da for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Dec 2006 15:04:39 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Gvflu-0001pI-49 for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2006 15:04:38 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Gvfls-0001mS-Ri for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2006 15:04:37 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gvfls-0001mK-Lg for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2006 15:04:36 -0500 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.52) id 1Gvfls-0006Tm-9F for bug-gnu-emacs@gnu.org; Sat, 16 Dec 2006 15:04:36 -0500 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.52) id 1Gvflp-00048D-Hr; Sat, 16 Dec 2006 15:04:33 -0500 Original-To: "Ilya N. Golubev" 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" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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:15469 Archived-At: The description with exactly that much detail has to exist, so that maintainers can quickly get to it and not ask users to educate them on package they are supposed to maintain. Perhaps the description is indeed too detailed for regular user. Then it just should be placed not in user manual, but elsewhere in emacs distribution, with reference to it from manual. Maybe you are right in this point. Which are the maintainers that need to know this information? Is it maintainers of shell.el, or maintainers of other parts of Emacs? If just shell.el, let's put it in a comment. If maintainers of other parts, let's put it in some doc string.