From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: MON KEY Newsgroups: gmane.emacs.bugs Subject: bug#7136: Documentation: `completion-in-region-functions' punts to opacity Date: Wed, 29 Sep 2010 17:15:34 -0400 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: dough.gmane.org 1285796496 18235 80.91.229.12 (29 Sep 2010 21:41:36 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 29 Sep 2010 21:41:36 +0000 (UTC) To: 7136@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Sep 29 23:41:33 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 1P14P6-0001Et-Pe for geb-bug-gnu-emacs@m.gmane.org; Wed, 29 Sep 2010 23:41:33 +0200 Original-Received: from localhost ([127.0.0.1]:59607 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P14P6-0003Me-CM for geb-bug-gnu-emacs@m.gmane.org; Wed, 29 Sep 2010 17:41:32 -0400 Original-Received: from [140.186.70.92] (port=48790 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P14P1-0003MZ-4Q for bug-gnu-emacs@gnu.org; Wed, 29 Sep 2010 17:41:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1P14P0-0008F5-1O for bug-gnu-emacs@gnu.org; Wed, 29 Sep 2010 17:41:27 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:60322) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1P14Oz-0008F1-Uv for bug-gnu-emacs@gnu.org; Wed, 29 Sep 2010 17:41:26 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1P13xW-00017g-2Q; Wed, 29 Sep 2010 17:13:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: MON KEY Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 29 Sep 2010 21:13:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 7136 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.12857947714308 (code B ref -1); Wed, 29 Sep 2010 21:13:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 29 Sep 2010 21:12:51 +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 1P13xL-00017R-5b for submit@debbugs.gnu.org; Wed, 29 Sep 2010 17:12:51 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1P13xI-00017M-Jz for submit@debbugs.gnu.org; Wed, 29 Sep 2010 17:12:48 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1P1405-0005VT-Bj for submit@debbugs.gnu.org; Wed, 29 Sep 2010 17:15:42 -0400 Original-Received: from lists.gnu.org ([199.232.76.165]:37766) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1P1405-0005VO-9h for submit@debbugs.gnu.org; Wed, 29 Sep 2010 17:15:41 -0400 Original-Received: from [140.186.70.92] (port=43458 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P1402-0007qc-L9 for bug-gnu-emacs@gnu.org; Wed, 29 Sep 2010 17:15:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1P1401-0005Ut-Cc for bug-gnu-emacs@gnu.org; Wed, 29 Sep 2010 17:15:38 -0400 Original-Received: from mail-ww0-f49.google.com ([74.125.82.49]:60835) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1P1401-0005Uk-1I for bug-gnu-emacs@gnu.org; Wed, 29 Sep 2010 17:15:37 -0400 Original-Received: by wwb24 with SMTP id 24so1433643wwb.30 for ; Wed, 29 Sep 2010 14:15:35 -0700 (PDT) Original-Received: by 10.216.159.6 with SMTP id r6mr3077149wek.55.1285794935000; Wed, 29 Sep 2010 14:15:35 -0700 (PDT) Original-Received: by 10.216.67.195 with HTTP; Wed, 29 Sep 2010 14:15:34 -0700 (PDT) X-Google-Sender-Auth: FrUHBwKDkM-WoXIogoQM72BX0aQ X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 29 Sep 2010 17:13:02 -0400 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:40557 Archived-At: Docstring of variable `completion-in-region-functions' has this: ,---- | NEXT-FUN is a function of four arguments (START END COLLECTION PREDICATE) | that performs the default operation. The other four arguments are like | the ones passed to `completion-in-region'. `---- The punting in the second sentence above (e.g. "The other four") is not helpful in the least. The fourth arg PREDICATE is not documented in `completion-in-region'. Examining the source for `completion-in-region' one finds its first evaluated form is a call to the `with-wrapper-hook' macro with `completion-in-region-functions' as its first arg. That `with-wrapper-hook' is itself recursive `labels' call with lexical closures over its args renders the `completion-in-region-functions' docstring completely opaque. -- /s_P\