Re: [PATCH v3] Allow applying filters to summary consecutively

[Robert Pluim <rpluim@gmail.com>]

>>>>> On Thu, 10 Nov 2022 10:06:00 +0200, Eli Zaretskii <eliz@gnu.org> said:

    >> From: Richard Stallman <rms@gnu.org>
    >> Cc: eliz@gnu.org, rpluim@gmail.com, emacs-devel@gnu.org
    >> Date: Wed, 09 Nov 2022 23:04:02 -0500
    >> 
    >> Does it mean "using one summary filtering cpmmand when a filtered
    >> summary already exists"?  That is the meaning I would expect in this
    >> case.  But if so, "consecutive commands" is not the way to say it.

    Eli> Your guess is correct.  I was struggling with finding a good
    Eli> description for this.  What would you suggest as a good wording?

I think we can keep it down to one sentence if we follow the 'describe
what it affects' guidance for docstrings, which allows dropping the
'if non-nil' bit. So something like:

"Whether summary filtering commands apply to an existing summary.
If nil, a new filtered summary is created, if non-nil, subsequent
filtering commands apply to an existing filtered summary.  This allows
the user to apply one filter after the other and keep narrowing the
results."

(the name of the option may need to change)

Robert
--