GNU bug report logs -
#4563
23.1; Doc for partial completion and completion styles
Previous Next
Full log
View this message in rfc822 format
[Message part 1 (text/plain, inline)]
Your message dated Sat, 28 Jan 2012 12:01:18 +0800
with message-id <87obtoh3w1.fsf <at> gnu.org>
and subject line Re: 23.1; Doc for partial completion and completion styles
has caused the debbugs.gnu.org bug report #4563,
regarding 23.1; Doc for partial completion and completion styles
to be marked as done.
(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)
--
4563: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=4563
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
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 part 3 (message/rfc822, inline)]
The documentation for completion styles has been completed in the trunk,
so this bug report is out of date; closing.
This bug report was last modified 13 years and 178 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.