Skip to content

Change --exclude value name from 'pattern' to 'glob'#1921

Merged
tmccombs merged 1 commit intosharkdp:masterfrom
rexkirshner:fix-exclude-value-name-glob
Mar 17, 2026
Merged

Change --exclude value name from 'pattern' to 'glob'#1921
tmccombs merged 1 commit intosharkdp:masterfrom
rexkirshner:fix-exclude-value-name-glob

Conversation

@rexkirshner
Copy link
Copy Markdown
Contributor

Summary

Fixes #1724

The summary line -E, --exclude <pattern> is misleading because fd defaults to regex for its main search pattern, but --exclude takes a glob. Users naturally assume --exclude also takes regex.

Changed the value placeholder from pattern to glob in:

  • CLI help text (value_name in clap)
  • Man page (doc/fd.1)
  • README

Test plan

  • Verified the help text change is consistent across all three locations
  • No behavioral change, documentation only

The summary line `-E, --exclude <pattern>` is misleading because fd
defaults to regex for its main search pattern, but --exclude takes a
glob. Rename the value placeholder to "glob" in the CLI help, man page,
and README to match the actual behavior.

Fixes sharkdp#1724

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
Collaborator

@tmccombs tmccombs left a comment

Choose a reason for hiding this comment

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

It isn't completely accurate, because it is actually a gitignore rule, which supports more syntax than just a glob, but it's close enough.

@tmccombs tmccombs merged commit fcd8466 into sharkdp:master Mar 17, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update manual: --exclude glob on summary line

2 participants