Commit Graph

51 Commits

Author SHA1 Message Date
David Peter b5344dac30 Improve -x/-X help text and man page description
closes #605
2021-08-08 22:58:13 +02:00
Archer Stéphane 5d2e011e90 change documentation message after feedbacks 2021-02-13 21:24:15 +01:00
Archer Stéphane 64bde11887 Try to clarify the documentation for -x command
see issue #712
2021-02-13 21:24:15 +01:00
Richard Taityr b928af7d9c
fix typo (#723) 2021-02-02 22:37:36 -07:00
Chathika Weerasuriya 9bc20e38b1 fixed: typographic error in help
- Changed "extention" to "extension"
2021-01-15 19:33:34 +01:00
sharkdp 17bd256ae6 Improve --fixed-strings help text, closes #627 2020-12-06 14:57:47 +01:00
sharkdp d2659de782 Improve --extension help text, closes #673 2020-12-06 12:20:50 +01:00
sharkdp d205a7ff9e Improve --exclude help text, closes #661 2020-12-06 12:15:01 +01:00
Platon Pronko e97a1e90cb Add exact size support to the --size filter (#669) 2020-12-06 11:47:27 +01:00
Andreas Lappe 2338b3bc81 Fix typo in fd.1 2020-12-04 12:04:19 +01:00
Nick Flueckiger 24402dda7c Remove .UE and .UR to fix url display on macos 2020-11-06 21:44:21 +01:00
Matthias Reitinger ec4cc981fc
Add --prune flag
closes #535
2020-10-25 08:16:01 +01:00
Matthias Reitinger e852009876 Add NO_COLOR to the man page 2020-10-24 12:15:06 +02:00
Allen Wild 99934ab98c add --base-directory, --path-separator, and --search-path to the man page
These options are in `fd --help` but missing from the man page.
Also fix a typo in the help text for --base-directory.
2020-10-14 08:35:09 +02:00
sharkdp e3c77ef7f5 Update --size documentation
closes #584
2020-05-19 17:06:32 +02:00
Bobbie Soedirgo 79d5a5bdc5 Add global fdignore support 2020-05-18 21:19:09 +02:00
Alexandru Macovei a9dc45ecb1 [ownership] document --owner in manpage and changelog 2020-05-18 21:11:33 +02:00
sharkdp cb56add1d8 Add new `--type socket` and `--type pipe` filters
closes #511
2020-04-16 09:59:45 +02:00
sharkdp d63c63be8c Add --min-depth and --exact-depth
Add new `--min-depth <depth>` and `--exact-depth <depth>` options in addition to the existing
option to limit the maximum depth.

closes #404
2020-04-15 17:02:41 +02:00
Danny Mösch 2bab4a2249 Add alias -1 for --max-results=1 2020-04-10 21:39:30 +02:00
sharkdp 33df48ebe4 Remove claim about unique search results 2020-04-03 10:07:46 +02:00
sharkdp c9dc617711 Rename --list to --list-details 2020-04-03 09:58:47 +02:00
sharkdp da5cd12b24 Add `-l`/`--list` option
Add a new `-l`/`--list` option to show more details about the search results. This is basically
an alias for `--exec-batch ls -l` with some additional `ls` options.
This can be used in order to:
    * see metadata like permissions, owner, file size, modification times (#491)
    * see symlink targets (#482)
    * achieve a deterministic output order (#324, #196, #159)
    * avoid duplicate search results when multiple search paths are given (#405)
2020-04-03 09:58:47 +02:00
sharkdp d43827fe57 Add --max-results=<count> option
This new option can be used instead of piping to `head -n <count>` for
improved performance:

| Command | Mean [ms] | Min [ms] | Max [ms] | Relative |
|:---|---:|---:|---:|---:|
| `fd --max-buffer-time=0 flow.yaml` | 153.9 ± 2.5 | 151.3 | 170.3 | 4.21 ± 5.86 |
| `fd --max-buffer-time=0 flow.yaml \| head -n 1` | 145.3 ± 17.4 | 111.0 | 180.2 | 3.98 ± 5.55 |
| `fd --max-results=1 flow.yaml` | 36.5 ± 50.8 | 7.2 | 145.7 | 1.00 |

Note: there is a large standard deviation on the last result due to the
non-deterministic file system traversal. With `--max-results`, we don't
have to traverse the whole filesystem tree, so it's all about luck.

closes #472
closes #476
2020-04-02 20:27:41 +02:00
Caleb Webber cab4981b11
Add --one-file-system and aliases to man page (#548) 2020-03-15 22:03:51 +01:00
sharkdp 0895027ed6 Add 'glob' syntax link as well 2019-11-25 00:14:26 +01:00
Deepansh c60cf9c1a8 Update man page 2019-11-25 00:14:26 +01:00
Nathan Henrie 59c27baf0f Expand help for `-u`, add to manpage 2019-09-17 22:21:37 +02:00
sharkdp fe79b8ce0a Update man page 2019-09-15 17:10:31 +02:00
Jason Heeris 1daa454615 Added detail on parallel execution job pool to man page and README. 2019-06-17 19:21:47 +02:00
Alex Leferry 2 46e865f1a2 Fix documentation to filter search by directory type 2019-02-19 07:21:02 +01:00
sharkdp 7f58e8f706 Update man page 2019-02-13 20:04:37 +01:00
sharkdp f09f038bd2 Add .gitattributes files 2018-11-12 21:26:46 +01:00
sharkdp 8832e471bc Update man page 2018-10-27 17:07:09 +02:00
sharkdp 2465cd1399 Update man page 2018-08-19 18:50:47 +02:00
sharkdp aa70c5a446 Add `--type empty`
Add a new `empty`/`e` type to search for empty files and/or directories.

To search for both empty files and directories, use one of the
following:

    fd --type empty
    fd -te

    fd --type empty --type file --type directory

To search for empty files, use

    fd --type empty --type file
    fd -te -tf

To search for empty directories, use

    fd --type empty --type directory
    fd -te -td

closes #273
2018-08-19 17:05:04 +02:00
sharkdp 388b90e624 Update USAGE and man page 2018-03-26 10:25:33 +02:00
sharkdp e30bc16780 Fix symlink filetype shortcut in man page 2018-02-21 22:58:22 +01:00
sharkdp b4be1f161c Add support for .fdignore files 2018-02-21 22:55:26 +01:00
sharkdp 814d37030e Implement -F/--fixed-strings/--literal 2018-02-10 15:55:06 +01:00
sharkdp 6d83eea32b Small screencast updates 2018-01-28 15:44:07 +01:00
sharkdp 941caeb053 Update documentation 2018-01-03 10:40:28 +01:00
sharkdp aaf9e024d5 Updates for 6.1.0 2017-12-09 21:40:13 -08:00
ptzz 9bd1d12c00 Add --no-ignore-vcs option
When passed, .gitignore files will not be respected.
2017-11-22 23:18:22 +01:00
sharkdp 9be32fa6a7 Bump version number 2017-11-15 23:39:55 +01:00
Matthias Reitinger 355a171557 Fix manpage formatting 2017-11-15 23:18:36 +01:00
Matthias Reitinger 5f4a1203b4 Update documentation for --exec syntax change 2017-11-15 23:18:36 +01:00
sharkdp 7b8d9322ba README and man page updates. 2017-10-25 22:43:36 +02:00
sharkdp f4ed2ba74d Man page updates
[skip ci]
2017-10-25 21:16:35 +02:00
Ivan Tham ddfa0873fb Shorten man page with some fixes
Maybe in the future we need to redirect `--help` to the man pages? Is there a way for cargo to install the man pages?
2017-10-19 20:10:34 +02:00