mirror of
https://github.com/sharkdp/fd
synced 2024-10-07 08:19:09 +00:00
Add troubleshooting section, closes #386
This commit is contained in:
parent
2672d84160
commit
85f9db0565
29
README.md
29
README.md
|
@ -427,6 +427,35 @@ If we want to run a command on all search results, we can pipe the output to `xa
|
||||||
Here, the `-0` option tells *fd* to separate search results by the NULL character (instead of
|
Here, the `-0` option tells *fd* to separate search results by the NULL character (instead of
|
||||||
newlines). In the same way, the `-0` option of `xargs` tells it to read the input in this way.
|
newlines). In the same way, the `-0` option of `xargs` tells it to read the input in this way.
|
||||||
|
|
||||||
|
### Troubleshooting
|
||||||
|
|
||||||
|
#### `fd` does not find my file!
|
||||||
|
|
||||||
|
Remember that `fd` ignores hidden directories and files by default. It also ignores patterns
|
||||||
|
from `.gitignore` files. If you want to make sure to find absolutely every possible file, always
|
||||||
|
use the options `-H` and `-I` to disable these two features:
|
||||||
|
``` bash
|
||||||
|
> fd -HI …
|
||||||
|
```
|
||||||
|
|
||||||
|
#### `fd` doesn't seem to interpret my regex pattern correctly
|
||||||
|
|
||||||
|
A lot of special regex characters (like `[]`, `^`, `$`, ..) are also special characters in your
|
||||||
|
shell. If in doubt, always make sure to put single quotes around the regex pattern:
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
> fd '^[A-Z][0-9]+$'
|
||||||
|
```
|
||||||
|
|
||||||
|
If your pattern starts with a dash, you have to add `--` to signal the end of command line
|
||||||
|
options. Otherwise, the pattern will be interpreted as a command-line option. Alternatively,
|
||||||
|
use a character class with a single hyphen character:
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
> fd -- '-pattern'
|
||||||
|
> fd '[-]pattern'
|
||||||
|
```
|
||||||
|
|
||||||
### Integration with other programs
|
### Integration with other programs
|
||||||
|
|
||||||
#### Using fd with `fzf`
|
#### Using fd with `fzf`
|
||||||
|
|
Loading…
Reference in a new issue