Skip to content

Commit

Permalink
docs: document that multiple --filters are unions (#5247)
Browse files Browse the repository at this point in the history
Co-authored-by: Greg Soltis <greg.soltis@vercel.com>
  • Loading branch information
mehulkar and Greg Soltis authored Jun 8, 2023
1 parent b8e4245 commit bb2eb28
Showing 1 changed file with 5 additions and 2 deletions.
7 changes: 5 additions & 2 deletions docs/pages/repo/docs/reference/command-line-reference/run.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -131,9 +131,11 @@ for execution.

Multiple filters can be combined to select distinct sets of targets. Additionally, filters
can also exclude targets. A target that matches any filter and is not explicitly excluded will
be in the final entrypoint selection.
be in the final entrypoint selection. In other words, the final list of targets is a _union_
of all the targets matching the filters provided, minus the union of targets that have been excluded.

For more detailed information about the `--filter` flag and filtering, refer to the [dedicated page in our documentation](/repo/docs/core-concepts/monorepos/filtering).
For more detailed information about the `--filter` flag and filtering, refer to
the [dedicated page in our documentation][3].

```sh
turbo run build --filter=my-pkg
Expand Down Expand Up @@ -488,3 +490,4 @@ turbo run build --since=origin/main

[1]: /repo/docs/reference/configuration#passThroughEnv
[2]: /repo/docs/reference/configuration#globalPassThroughEnv
[3]: /repo/docs/core-concepts/monorepos/filtering

1 comment on commit bb2eb28

@vercel
Copy link

@vercel vercel bot commented on bb2eb28 Jun 8, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please sign in to comment.