GNU bug report logs - #7136
Documentation: `completion-in-region-functions' punts to opacity

Previous Next

Full log

View this message in rfc822 format

From: MON KEY <monkey <at> sandpframing.com>
To: 7136 <at> debbugs.gnu.org
Subject: bug#7136: Documentation: `completion-in-region-functions' punts to opacity
Date: Wed, 29 Sep 2010 17:15:34 -0400

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\

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.