Commit Graph

59 Commits

Author SHA1 Message Date
David Peter 359c0269ba Remove example from man page 2021-11-26 17:40:42 +01:00
Jonah Caplan 12650a0913 add example to man page and correct test comment 2021-10-15 23:57:03 -04:00
Thayne McCombs 78e21395b8 Make list of ignore files for `--no-ignore` more explicit 2021-08-15 12:52:10 +02:00
Thayne McCombs 1b52948e42 Add better documentation of vcs-ignore files.
Explicitly list which files are used for gitignore.

Fixes #354
2021-08-15 12:52:10 +02:00
Asha20 334488cab7
Add -q/--quiet/--has-match flag (#813)
Instead of printing to stdout, the program will return 1 as the exit
code if there are no matches and 0 otherwise.
2021-08-14 17:57:01 +02:00
a1346054 1c72f80ff5 fix whitespace 2021-08-14 16:21:02 +02:00
Thayne McCombs 1795e0e9dd Add documentation and examples of ** in glob mode
And how it should be used with the `--full-path` option.

Fixes #764.
2021-08-10 20:53:56 +02:00
Jacob Mischka ba60a163fe Use local times for time functions
This patch uses Chrono for explicit date or datetime parsing, only using
humantime for its relative time parsing. The following formats are accepted:

1. Full RFC3339 parsing, requiring an explicit timezone
2. `YY-MM-DD`, defaulting to time `00:00:00` for the given date in the
   local time zone
3. `YY-MM-DD HH:MM:SS` in the local time zone

Fixes #631, #794
2021-08-09 13:40:55 +02:00
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