Re: Simplification of `affixation-function`

[Daniel Mendler <mail@daniel-mendler.de>]

On 4/24/21 11:41 PM, Juri Linkov wrote:> We could just change the 
documentation of ‘affixation-function’ to define
> only one supported way of using the “completion + prefix + suffix” format
> to reduce confusion.

This is a "resolution" I would not be happy with. We still keep around 
an obsolete format (which has only been introduced a few months ago) and 
then keep it out of the documentation. I think it is preferable to 
correct the definition then.

But it is okay to keep the current definition if you think the costs of 
a change outweigh the benefits.

 > I'd prefer to support additional text using keywords, e.g.
 > ("completion" "prefix" "suffix" :help "Help text")

The suggestion with the keywords is nice. If you plan to allow such 
additional keywords, this should be documented then, since completion 
UIs rely on the documentation when they implement support for the 
function. Which formats will be allowed? We already have `(candidate 
suffix)` and `(candidate prefix suffix)`.

For extensibility one may want to add

(candidate :prefix prefix :suffix suffix :other-keys...)

or as you proposed

(candidate prefix suffix :other-keys...).

Daniel