From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Ilya N. Golubev" Newsgroups: gmane.emacs.bugs Subject: what makes read it? [Re: shell completion documentation] Date: Wed, 20 Dec 2006 23:59:33 +0300 Message-ID: <17mz5iqo5m.fsf_-_@mo.msk.ru> 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> <12d56hgh1q.fsf@mo.msk.ru> NNTP-Posting-Host: dough.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1166650325 25539 80.91.229.10 (20 Dec 2006 21:32:05 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 20 Dec 2006 21:32:05 +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 22:32:03 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 1Gx92d-0000Id-O4 for geb-bug-gnu-emacs@m.gmane.org; Wed, 20 Dec 2006 22:32:00 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gx92d-0001dD-5L for geb-bug-gnu-emacs@m.gmane.org; Wed, 20 Dec 2006 16:31:59 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Gx92b-0001co-N4 for bug-gnu-emacs@gnu.org; Wed, 20 Dec 2006 16:31:57 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Gx92a-0001bu-4p for bug-gnu-emacs@gnu.org; Wed, 20 Dec 2006 16:31:56 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gx92Z-0001bj-Nk for bug-gnu-emacs@gnu.org; Wed, 20 Dec 2006 16:31:55 -0500 Original-Received: from [62.213.85.9] (helo=d-fens.mopniei.ru) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA:32) (Exim 4.52) id 1Gx8XI-00011U-8U; Wed, 20 Dec 2006 15:59:37 -0500 Original-Received: from d-fens.mopniei.ru (localhost.localdomain [127.0.0.1]) by d-fens.mopniei.ru (8.13.7/8.13.7) with ESMTP id kBKKxXRV014906 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 20 Dec 2006 23:59:33 +0300 Original-Received: (from gin@localhost) by d-fens.mopniei.ru (8.13.7/8.13.7/Submit) id kBKKxXNW014905; Wed, 20 Dec 2006 23:59:33 +0300 X-Authentication-Warning: d-fens.mopniei.ru: gin set sender to gin@mo.msk.ru using -f Original-To: rms@gnu.org In-Reply-To: (Richard Stallman's message of "Wed, 20 Dec 2006 08:00:51 -0500") User-Agent: Gnus/5.1007 (Gnus v5.10.7) XEmacs/21.4.20 (linux) 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:15476 Archived-At: > People normally read the comments in the vicinity of the code they are > working on. Remember, the case is that they feel that bug report (combined with package documentation) is incomplete. So most likely they will not look at code at all. Even if they do, what will be the ? Most likely just the place found by `find-function', far from beginning of the file. So the issue What will make maintainers read it before sending (unnecessary) questions to users? remains. It appears that at least a reference in manual is necessary.