GNU bug report logs - #7499
Documentation: `comint-dynamic-list-filename-completions'

Previous Next

Full log

View this message in rfc822 format

From: MON KEY <monkey <at> sandpframing.com>
To: Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: 7499 <at> debbugs.gnu.org
Subject: bug#7499: Documentation: `comint-dynamic-list-filename-completions'
Date: Sun, 28 Nov 2010 15:46:58 -0500

On Sat, Nov 27, 2010 at 1:35 PM, Stefan Monnier
<monnier <at> iro.umontreal.ca> wrote:

> 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*".

Its docstring is equally suspect:

,---- (documentation 'comint-dynamic-list-completions)
|
|     List in help buffer sorted completions.  The meaning of
|     common-substring is the same as in `display-completion-list'.
|     Typing SPC flushes the help buffer.
|
`----

W/re `comint-dynamic-list-completions',
`comint-dynamic-list-filename-completions' (and any other similar such
comint docstrings), what would prob. be more "helpful to the user"
would be to explicitly document that return value is to
"*Completions*". :)

After all, there is no provision for an alternative destination
stream.  Indeed, it is doubtful such alternatives could be made
available via `comint-dynamic-list-completions' given the complicated
interactions between windows/buffers/configurations and the dynamic bindings of
`standard-output' happening around the internal calls to
`display-completion-list' and `with-output-to-temp-buffer'.

>        Stefan

--
/s_P\

Previous Next

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