GNU bug report logs - #13993
24.3.50; doc of `complete-with-action'

Previous Next

Full log

View this message in rfc822 format

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 13993 <at> debbugs.gnu.org
Subject: bug#13993: 24.3.50; doc of `complete-with-action'
Date: Wed, 14 Aug 2019 22:44:41 -0700

"Drew Adams" <drew.adams <at> oracle.com> writes:

> The doc of `complete-with-action' should do more, however.  It should
> say what it does:
>
> If TABLE is a function then TABLE does all of the completing.  It is
> passed arguments STRING, PRED, and ACTION. (and refer to (or copy)
> existing doc about this).
>
> Else the behavior depends on the value of ACTION:
>
>  If `metadata' or a cons with car `boundaries' then return nil.
>  If nil, return (try-completion STRING TABLE PRED).
>  If t,   return (all-completions STRING TABLE PRED).
>  Else    return (test-completion STRING TABLE PRED).

I've now altered the doc string along the lines of what you suggest, but
less verbose.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

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