doc: note that ripgrep may terminate unexpectedly

Fixes #581
This commit is contained in:
Andrew Gallant 2017-08-23 19:14:27 -04:00
parent 01358a155c
commit 398326bfe2
No known key found for this signature in database
GPG Key ID: B2E3A4923F8B0D44
3 changed files with 27 additions and 1 deletions

View File

@ -29,6 +29,10 @@ time searching.
Because of this, features like backreferences and arbitrary lookaround Because of this, features like backreferences and arbitrary lookaround
are not supported. are not supported.
.PP .PP
Note that ripgrep may abort unexpectedly when using default settings if
it searches a file that is simultaneously truncated.
This behavior can be avoided by passing the \-\-no\-mmap flag.
.PP
Project home page: https://github.com/BurntSushi/ripgrep Project home page: https://github.com/BurntSushi/ripgrep
.SH COMMON OPTIONS .SH COMMON OPTIONS
.TP .TP
@ -45,7 +49,10 @@ Only show count of line matches for each file.
.B \-\-color \f[I]WHEN\f[] .B \-\-color \f[I]WHEN\f[]
Whether to use color in the output. Whether to use color in the output.
Valid values are never, auto, always or ansi. Valid values are never, auto, always or ansi.
[default: auto] The default is auto.
When always is used, coloring is attempted based on your environment.
When ansi is used, coloring is forcefully done using ANSI escape color
codes.
.RS .RS
.RE .RE
.TP .TP
@ -299,6 +306,17 @@ Search hidden directories and files.
.RS .RS
.RE .RE
.TP .TP
.B \-\-iglob \f[I]GLOB\f[] ...
Include or exclude files/directories case insensitively.
This always overrides any other ignore logic if there is a conflict, but
is otherwise applied in addition to ignore files (e.g., .gitignore or
\&.ignore).
Multiple glob flags may be used.
Globbing rules match .gitignore globs.
Precede a glob with a \[aq]!\[aq] to exclude it.
.RS
.RE
.TP
.B \-\-ignore\-file \f[I]FILE\f[] ... .B \-\-ignore\-file \f[I]FILE\f[] ...
Specify additional ignore files for filtering file paths. Specify additional ignore files for filtering file paths.
Ignore files should be in the gitignore format and are matched relative Ignore files should be in the gitignore format and are matched relative

View File

@ -25,6 +25,10 @@ ripgrep's regex engine uses finite automata and guarantees linear time
searching. Because of this, features like backreferences and arbitrary searching. Because of this, features like backreferences and arbitrary
lookaround are not supported. lookaround are not supported.
Note that ripgrep may abort unexpectedly when using default settings if it
searches a file that is simultaneously truncated. This behavior can be avoided
by passing the --no-mmap flag.
Project home page: https://github.com/BurntSushi/ripgrep Project home page: https://github.com/BurntSushi/ripgrep
# COMMON OPTIONS # COMMON OPTIONS

View File

@ -9,6 +9,10 @@ ripgrep's regex engine uses finite automata and guarantees linear time
searching. Because of this, features like backreferences and arbitrary searching. Because of this, features like backreferences and arbitrary
lookaround are not supported. lookaround are not supported.
Note that ripgrep may abort unexpectedly when using default settings if it
searches a file that is simultaneously truncated. This behavior can be avoided
by passing the --no-mmap flag.
Project home page: https://github.com/BurntSushi/ripgrep Project home page: https://github.com/BurntSushi/ripgrep
Use -h for short descriptions and --help for more details."; Use -h for short descriptions and --help for more details.";