Commit graph

58 commits

Author SHA1 Message Date
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
sharkdp
aaf9e024d5 Updates for 6.1.0 2017-12-09 21:40:13 -08:00