doc: clarify failure mode

This adds a hint for end users that run into a common failure mode where
ripgrep won't search any files because they have a `*` rule in their
`$HOME/.gitignore`.

Fixes #815
This commit is contained in:
Andrew Gallant 2018-02-20 19:39:16 -05:00
parent d65966efbc
commit 8c800adab7

View File

@ -58,6 +58,10 @@ $ rg fast README.md
129: optimizations to make searching very fast. 129: optimizations to make searching very fast.
``` ```
(**Note:** If you see an error message from ripgrep saying that it didn't
search any files, then re-run ripgrep with the `--debug` flag. One likely cause
of this is that you have a `*` rule in a `$HOME/.gitignore` file.)
So what happened here? ripgrep read the contents of `README.md`, and for each So what happened here? ripgrep read the contents of `README.md`, and for each
line that contained `fast`, ripgrep printed it to your terminal. ripgrep also line that contained `fast`, ripgrep printed it to your terminal. ripgrep also
included the line number for each line by default. If your terminal supports included the line number for each line by default. If your terminal supports