GNU bug report logs - #24663
24.5; doc string of `completion-at-point-functions'

Previous Next

Full log

Message #13 received at 24663-done <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>, Drew Adams <drew.adams <at> oracle.com>
Cc: 24663-done <at> debbugs.gnu.org
Subject: RE: bug#24663: 24.5; doc string of `completion-at-point-functions'
Date: Thu, 13 Oct 2016 12:46:19 -0700 (PDT)

> > 3. "the thing at point" means nothing.  Thing at point means something
> > only for a given type of THING.  There is not just one ("the") thing
> > at point.
> >
> > Presumably what is meant here is not a thing at point but some text
> > preceding point.  It is some text before point that is completed.
> 
> I don't understand what are you saying here.  Sure, it's some text at
> point, but the form of that text might describe a symbol, an
> expression, a string, etc.
> 
> I changed that to say "the entity at point" because the rest of the
> doc string refers to that.

1. It cannot be "THE" thing (or THE entity) at point.  Which one?
You can get different kinds of thing at point.  You must provide
the desired THING type, for "thing at point" to mean anything.
How is the type of thing (or entity) decided, here?  If the user
is not specifying it (which I think is the case) then the doc
should say something about how the type is chosen.

2. I don't see how/why saying "entity" changes anything, here.
"THE" entity?  What is that?

3. It is not text AT point that is completed.  It is text BEFORE
point that is completed.  AT can only refer to characters after
point, not before.

Previous Next

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