doc/ivy.org: Add a note on :predicate

[gnu-emacs-elpa] / doc / ivy.org

diff --git a/doc/ivy.org b/doc/ivy.org
index d8b397abb52c15f1cf7f1b23238293fc5508d67b..8c0f35757f7d6d976007a6960d5fcf33efa41123 100644 (file)
--- a/doc/ivy.org
+++ b/doc/ivy.org
@@ -1070,7 +1070,9 @@ features such as multi-actions, non-exiting actions, =ivy-occur= and
 :END:
 - =predicate= ::
      Is a function to filter the initial collection. It has to be
-     compatible with =all-completions=.
+     compatible with =all-completions=. Tip: most of the time, it's
+     simpler to just apply this filter to the =collection= argument
+     itself, e.g. =(cl-remove-if-not predicate collection)=.
 - =require-match= ::
      When set to a non-nil value, input must match one of the
      candidates. Custom input is not accepted.