From 9e62e9aa2386814ca0cd386933e4d084b76240f0 Mon Sep 17 00:00:00 2001 From: Sascha Bratton Date: Thu, 2 Jul 2026 15:49:33 -0400 Subject: [PATCH] docs: clarify predicate-quantifier output semantics --- README.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 0eb16ca..f0f3948 100644 --- a/README.md +++ b/README.md @@ -173,10 +173,13 @@ For more information, see [CHANGELOG](https://github.com/dorny/paths-filter/blob ## Outputs -- Each filter sets an output variable named by the filter to the following text value: - - `'true'` - if **any** of the changed files match any filter rules with `predicate-quantifier` set to `'some'` (default) - - `'true'` - if **any** of the changed files match **all** filter rules with `predicate-quantifier` set to `'every'` - - `'false'` - if **none** of the changed files matches any of filter rules +- Each filter sets an output variable, named after the filter, whose text value depends on the `predicate-quantifier` setting: + - With `predicate-quantifier: 'some'` (default): + - `'true'` - if **any** changed file matches **at least one** of the filter's rules + - `'false'` - if **no** changed file matches **at least one** of the filter's rules + - With `predicate-quantifier: 'every'`: + - `'true'` - if **any** changed file matches **all** of the filter's rules + - `'false'` - if **no** changed file matches **all** of the filter's rules - Each filter sets an output variable with the name `${FILTER_NAME}_count` to the count of matching files. - If enabled, for each filter it sets an output variable with the name `${FILTER_NAME}_files`. It will contain a list of all files matching the filter. - `changes` - JSON array with names of all filters matching any of the changed files.