From 80cbb3e5f0303d8a047f600f855d59a30c55939e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A9rome=20Eertmans?= Date: Wed, 24 Apr 2024 09:50:09 +0200 Subject: [PATCH] chore(docs): update `--help` output in README.md --- README.md | 93 ++++++++++++++++++++++++++++--------------------------- 1 file changed, 48 insertions(+), 45 deletions(-) diff --git a/README.md b/README.md index f02d716..1729421 100644 --- a/README.md +++ b/README.md @@ -34,67 +34,70 @@ cargo install filesfinder After that, FilesFinder can be used via the `ff` alias. ```text -USAGE: - ff [OPTIONS] ... - ff [OPTIONS] [OPTIONS] ... +Find files within current directory that match given patterns, while respecting gitignore rules. -ARGS: - ... - A pattern to match against each file. +Usage: ff [OPTIONS] ... + ff [OPTIONS] [OPTIONS] ... -OPTIONS: - -g, -G - Parse pattern as a glob expression. - [default behavior] +Arguments: + ... + A pattern to match against each file - -r, -R - Parse pattern as a regular expression. - Note that expressions are unanchored by default. - Use '^' or '\A' to denote start, and '$' or '\z' for the end. +Options: + -h, --help + Print help (see a summary with '-h') - -i, -I - Matching files will be included in the output. - [default behavior] + -V, --version + Print version - -e, -E - Matching files will be excluded from the output. +Walk options: + -j + Number of threads to use. + + Setting this to zero will choose the number of threads automatically. - -j - Number of threads to use. - Setting this to zero will choose the number of threads automatically. - [default: num_cpus] + -d, --dir + Directory to search for files + + [default: .] - --dir - Files will be searched in the directory specified by the PATH. - Multiple occurences are allowed. - [default: '.'] + --max-depth + Maximum depth to recurse into directories - --max-depth - Maximum depth to recurse. - [default: None] + --follow-links + Allow to follow symbolic links - --follow-links - Allow to follow symbolic links. + -., --hidden + Search hidden files and directories. + + By default, hidden files and directories are skipped. - --show-hidden - Allow to show hidden files. + --no-gitignore + Ignore .gitignore files - --no-gitignore - Ignore .gitignore files. + --no-ignore + Ignore .ignore files - --no-ignore - Ignore .ignore files. +Match options: + -g + Parse pattern as a glob expression (default) [global alias: G] - --no-strip-prefix - Do not strip './' prefix, same as what GNU find does. + -r + Parse pattern as a regular expression. + + Note that expressions are unanchored by default. Use '^' or '\\A' to denote start, and '$' or + '\\z' for the end. - -h, --help - Print help information. + -i + Matching files will be included in the output (default) [global alias: I] - -V, --version - Print version information. + -e + Matching files will be excluded from the output [global alias: E] -NOTES: + --no-strip-prefix + Do not strip './' prefix, same as what GNU find does + +Notes: - Capitalized options (.e.g., '-G') apply to all subsequent patterns. E.g.: 'ff -g "*.rs" -g "*.md"' is equivalent to 'ff -G "*.rs" "*.md"'. You can always unset a flag by overriding it.