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

Message #17 received at 7499 <at> debbugs.gnu.org (full text, mbox):

From: Stefan Monnier <monnier <at> IRO.UMontreal.CA>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 7499 <at> debbugs.gnu.org, 'MON KEY' <monkey <at> sandpframing.com>
Subject: Re: bug#7499: Documentation:
	`comint-dynamic-list-filename-completions'
Date: Sun, 28 Nov 2010 20:35:52 -0500

> 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).

I'd argue instead that there is no reason for that text to say where
it's going to be displayed.
So I'd replace "List in help buffer sorted completions" with something
like "Display sorted completions".


        Stefan
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.