From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: bug#7499: Documentation: `comint-dynamic-list-filename-completions' Date: Sun, 28 Nov 2010 14:42:32 -0800 Message-ID: <9F21BBC03CC444F193C552C443F6B6E8@us.oracle.com> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1290984323 26486 80.91.229.12 (28 Nov 2010 22:45:23 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sun, 28 Nov 2010 22:45:23 +0000 (UTC) Cc: 7499@debbugs.gnu.org To: "'MON KEY'" , "'Stefan Monnier'" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Nov 28 23:45:19 2010 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PMpzh-0006aK-8w for geb-bug-gnu-emacs@m.gmane.org; Sun, 28 Nov 2010 23:45:18 +0100 Original-Received: from localhost ([127.0.0.1]:59708 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PMpzg-0000PM-Sw for geb-bug-gnu-emacs@m.gmane.org; Sun, 28 Nov 2010 17:45:16 -0500 Original-Received: from [140.186.70.92] (port=58001 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PMpzN-0000GB-JQ for bug-gnu-emacs@gnu.org; Sun, 28 Nov 2010 17:45:01 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PMpzL-0001Xk-FE for bug-gnu-emacs@gnu.org; Sun, 28 Nov 2010 17:44:57 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:57423) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PMpzL-0001Xe-CS for bug-gnu-emacs@gnu.org; Sun, 28 Nov 2010 17:44:55 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1PMptd-0001Ru-Me; Sun, 28 Nov 2010 17:39:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 28 Nov 2010 22:39:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 7499 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 7499-submit@debbugs.gnu.org id=B7499.12909838855507 (code B ref 7499); Sun, 28 Nov 2010 22:39:01 +0000 Original-Received: (at 7499) by debbugs.gnu.org; 28 Nov 2010 22:38:05 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PMpsi-0001Qm-QT for submit@debbugs.gnu.org; Sun, 28 Nov 2010 17:38:05 -0500 Original-Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1PMpsg-0001QJ-Ih for 7499@debbugs.gnu.org; Sun, 28 Nov 2010 17:38:02 -0500 Original-Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.2) with ESMTP id oASMhW3i006845 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Sun, 28 Nov 2010 22:43:33 GMT Original-Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id oASMhTap019241; Sun, 28 Nov 2010 22:43:30 GMT Original-Received: from abhmt019.oracle.com by acsmt354.oracle.com with ESMTP id 810550981290984161; Sun, 28 Nov 2010 14:42:41 -0800 Original-Received: from dradamslap1 (/10.159.220.140) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 28 Nov 2010 14:42:41 -0800 X-Mailer: Microsoft Office Outlook 11 In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5994 Thread-Index: AcuPQVtxeUuatx32T4iSaFPVNGuWEwAC8YKw X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sun, 28 Nov 2010 17:39:01 -0500 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: bug-gnu-emacs@gnu.org 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:41990 Archived-At: > > The term "help buffer" is apparently used here loosely to mean > > "auxiliary buffer helpful to the user". > > Its less than apparent (to me at least) that such loose usage > is helpful. :) AFAICT `comint-dynamic-list-completions' is > hardwired to "*Completions*". I haven't been following this thread (and no doubt will not follow it). But if the buffer is `*Completions*' then it is clearest for the doc to say so explicitly. Saying "help buffer" or even "some auxilliary buffer helpful to the user" just muddies the water. No need to defend that text; just use "buffer `*Completions*'" or "window `*Completions*'" (depending on the context).