docs: clarify repeated --exclude usage#18469
Open
liruiluo wants to merge 3 commits intoastral-sh:mainfrom
Open
docs: clarify repeated --exclude usage#18469liruiluo wants to merge 3 commits intoastral-sh:mainfrom
liruiluo wants to merge 3 commits intoastral-sh:mainfrom
Conversation
zanieb
reviewed
Mar 14, 2026
crates/uv-cli/src/lib.rs
Outdated
Comment on lines
+2545
to
+2546
| /// Exclude the specified package(s) from the output. Repeat to exclude | ||
| /// multiple packages, e.g., `--exclude pip --exclude setuptools`. |
Member
There was a problem hiding this comment.
This should not be included on the first line.
Suggested change
| /// Exclude the specified package(s) from the output. Repeat to exclude | |
| /// multiple packages, e.g., `--exclude pip --exclude setuptools`. | |
| /// Exclude the specified package(s) from the output. | |
| /// | |
| /// Repeat to exclude multiple packages, e.g., `--exclude pip --exclude setuptools`. |
Does the "Repeat to..." language match other options where we say a flag can be repeated? I don't think so?
zanieb
reviewed
Mar 14, 2026
docs/pip/inspection.md
Outdated
| $ uv pip freeze | ||
| ``` | ||
|
|
||
| Repeat `--exclude` to omit multiple packages from the output: |
Member
There was a problem hiding this comment.
It doesn't make sense to say "Repeat --exclude" here before introducing --exclude. Just explain --exclude can be used to omit packages.
I'm on the fence about explaining this functionality at all in this document, it doesn't seem valuable enough.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
--excludecan be repeateduv pip freeze --exclude ... --exclude ...exampleFixes #18429.