GNU bug report logs - #4563
23.1; Doc for partial completion and completion styles

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 4563 in the body.
You can then email your comments to 4563 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> emacsbugs.donarmstrong.com (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 23.1; Doc for partial completion and completion styles
Date: Sat, 26 Sep 2009 11:55:42 -0700

1. In the Emacs manual, add index entries for the predefined
completion styles: `basic', `partial-completion', `emacs22', and
`emacs21'.  Add index entries for partial completion (which covers
more than the completion style `partial-completion').
 
2. Node `Completion Commands' says that `*' matches any
character. AFAICT, this is incorrect. Instead, it matches any sequence
of characters (including an empty sequence).
 
3. The overall, default completion matching algorithm is described (in
node `Completion Commands'), but there is nothing there that indicates
which parts of this algorithm correspond to which parts of the default
value of option `completion-styles'.
 
There is thus no way for readers to know what the effect is of
including `partial-completion' (for example) in `completion-styles'.
That option is not even mentioned here, but it is central to the
behavior of completion, which this node describes.  There is no way
for readers to know how to change the default completion behavior -
there is not even a cross reference to node `Completion Options'.
 
4. The description in `Completion Commands' seems to imply that
characters `-' and ` ' have an effect only when "partial completion"
rules apply (presumably, that means when `partial-completion' is
included in `completion-styles', but there is no explanation here of
what "partial completion" is or what governs it).
 
That's OK as far as it goes (those two chars), but the description in
this node also seems to imply that `*' always has an effect, which is
incorrect.  AFAIK, `*' is part of the `partial-completion' style - if
you remove that style from `completion-styles', then `*' does not have
the effect described. The text covering `*' needs to be part of the
discussion of partial completion, to reduce its apparent scope.
 
5. `completion-styles' needs better documentation. It is mentioned in
node `Completion Options', but the description is not sufficient to
help users.  Each of the predefined completion styles needs to be
described.
 
For example, users should know what the effect is of including style
`emacs22' or `partial-completion'. It is not enough to describe the
overall effect of the default set of `completion-styles' - each style
should be described, so that users can effectively customize
`completion-styles'. That's the point of having a user option, and not
simply hard-coding the behavior.
 
6. The doc string of `completion-styles' is inadequate in this regard
also. It says simply "List of completion styles to use."
 
 
 
In GNU Emacs 23.1.1 (i386-mingw-nt5.1.2600)
 of 2009-07-29 on SOFT-MJASON
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.4)'
 

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

From: Chong Yidong <cyd <at> gnu.org>
To: 4563-done <at> debbugs.gnu.org
Subject: Re: 23.1; Doc for partial completion and completion styles
Date: Sat, 28 Jan 2012 12:01:18 +0800

The documentation for completion styles has been completed in the trunk,
so this bug report is out of date; closing.

Previous Next

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