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

Previous Next

Package: emacs;

Reported by: MON KEY <monkey <at> sandpframing.com>

Date: Sat, 27 Nov 2010 17:06:02 UTC

Severity: minor

Done: Chong Yidong <cyd <at> stupidchicken.com>

Bug is archived. No further changes may be made.

Full log

View this message in rfc822 format

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'MON KEY'" <monkey <at> sandpframing.com>, "'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 14:42:32 -0800

> > 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).
This bug report was last modified 14 years and 224 days ago.

Previous Next

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