[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#18281: 24.4.50; doc of `customize-apropos*'

From: Lars Ingebrigtsen
Subject: bug#18281: 24.4.50; doc of `customize-apropos*'
Date: Sat, 03 Aug 2019 20:53:39 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux)

Drew Adams <address@hidden> writes:

> This applies to `customize-apropos' and its related commands.
> 1. The doc is not clear wrt what happens when you provide a list of
> "words" as the input, instead of a regexp.
> It is very easily to misunderstand the inadequate description as saying
> that the words you enter are matched, not together sequentially against
> a single customize target, but individually against multiple customize
> targets.
> This is all the more true, since this command has as its aim to match
> any number of targets: it constructs a Customize buffer for all targets
> matched.
> Both the doc at (emacs) `Specific Customization' and the doc string are
> defective (misleading and incomplete) in this regard.
> The doc should say something like this:
>  If you provide a list of words then all possible pairs of the words are
>  matched together, in both orders, against the name of each Customize
>  object of TYPE.  That is, the object name must contain both words as
>  sbubstrings.

I don't know what the doc string said at the time you filed the report
(it would be helpful if you included that in your reports), but
currently it says:


Customize loaded options, faces and groups matching PATTERN.
PATTERN can be a word, a list of words (separated by spaces),
or a regexp (using some regexp special characters).  If it is a word,
search for matches for that word as a substring.  If it is a list of
words, search for matches for any two (or more) of those words.


That seems quite clear to me, and I'm closing this bug report.

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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]