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#14006: 24.3.50; doc of `completion-in-region-mode', `completion-in-region' Date: Wed, 20 Mar 2013 07:44:20 -0700 Message-ID: <70247DD667674DB692AC1FC2A72719CC@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1363790724 2219 80.91.229.3 (20 Mar 2013 14:45:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 20 Mar 2013 14:45:24 +0000 (UTC) To: 14006@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Mar 20 15:45:50 2013 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1UIKGz-0002F7-Oc for geb-bug-gnu-emacs@m.gmane.org; Wed, 20 Mar 2013 15:45:49 +0100 Original-Received: from localhost ([::1]:46103 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIKGc-0002s5-K7 for geb-bug-gnu-emacs@m.gmane.org; Wed, 20 Mar 2013 10:45:26 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:40383) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIKGY-0002rt-UX for bug-gnu-emacs@gnu.org; Wed, 20 Mar 2013 10:45:24 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UIKGT-0005HJ-TY for bug-gnu-emacs@gnu.org; Wed, 20 Mar 2013 10:45:22 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:33617) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIKGT-0005H8-N5 for bug-gnu-emacs@gnu.org; Wed, 20 Mar 2013 10:45:17 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1UIKIA-0003I4-Gv for bug-gnu-emacs@gnu.org; Wed, 20 Mar 2013 10:47:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 20 Mar 2013 14:47:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 14006 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: Original-Received: via spool by submit@debbugs.gnu.org id=B.136379078212590 (code B ref -1); Wed, 20 Mar 2013 14:47:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 20 Mar 2013 14:46:22 +0000 Original-Received: from localhost ([127.0.0.1]:37726 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UIKHV-0003H0-Kp for submit@debbugs.gnu.org; Wed, 20 Mar 2013 10:46:21 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:56906) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1UIKHU-0003Gv-BU for submit@debbugs.gnu.org; Wed, 20 Mar 2013 10:46:21 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UIKFi-0004p7-Iy for submit@debbugs.gnu.org; Wed, 20 Mar 2013 10:44:35 -0400 Original-Received: from lists.gnu.org ([208.118.235.17]:54170) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIKFi-0004p2-GN for submit@debbugs.gnu.org; Wed, 20 Mar 2013 10:44:30 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:40008) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIKFg-0001xa-VL for bug-gnu-emacs@gnu.org; Wed, 20 Mar 2013 10:44:30 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1UIKFe-0004oB-ED for bug-gnu-emacs@gnu.org; Wed, 20 Mar 2013 10:44:28 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:33115) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1UIKFe-0004o2-8V for bug-gnu-emacs@gnu.org; Wed, 20 Mar 2013 10:44:26 -0400 Original-Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by aserp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id r2KEiOuc001156 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 20 Mar 2013 14:44:24 GMT Original-Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id r2KEiNth023006 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Wed, 20 Mar 2013 14:44:24 GMT Original-Received: from abhmt112.oracle.com (abhmt112.oracle.com [141.146.116.64]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id r2KEiNDm017814 for ; Wed, 20 Mar 2013 09:44:23 -0500 Original-Received: from dradamslap1 (/71.202.147.44) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 20 Mar 2013 07:44:23 -0700 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac4leWgjeUVuI6ZlSqmYreWhDCJrWw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 140.186.70.43 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: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:72742 Archived-At: Doc string of `completion-in-region-mode' is useless. It says nothing more than that the mode is "used during `completion-in-region'. Used for what? Used how? What does it do? (And there is a typo presumably: "modemode". It doesn't seem like much thought or time was expended on this doc. Doc string of `completion-in-region' does not say how PREDICATE is used - what it means to "say when to exit" (how? why? exit what?). And it is not clear whether point can be START or END or both or neither: "between" generally excludes both end points, but the meaning should be made explicit. And nothing is said about what COLLECTION is - "using COLLECTION" means nothing. At least cross-ref some other doc that describes COLLECTION. (elisp) `Completion in Buffers' says little more than what the doc string of `completion-in-region' says. (At least it cross-references COLLECTION.) And it says nothing about `completion-in-region-mode'. In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2013-03-17 on ODIEONE Bzr revision: 112068 michael.albinus@gmx.de-20130317173046-sgy1bmmkkizorqby Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -IC:/Devel/emacs/build/include --ldflags -LC:/Devel/emacs/build/lib'