aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorThomas Voss <mail@thomasvoss.com> 2024-11-13 22:17:13 +0100
committerThomas Voss <mail@thomasvoss.com> 2024-11-13 22:17:13 +0100
commitb3fd0e0a2228c2501a14670440b48bbe6f036f07 (patch)
tree78c1750e16f2149bd1360a284c7ca35353d2d818 /man
parent0cf413c8a6a060fbc532f645202b01cf8ef27fef (diff)
Default back to -b from -Lv3.0.0
Diffstat (limited to 'man')
-rw-r--r--man/grab.123
1 files changed, 16 insertions, 7 deletions
diff --git a/man/grab.1 b/man/grab.1
index a2e5813..46826b2 100644
--- a/man/grab.1
+++ b/man/grab.1
@@ -72,6 +72,10 @@ of the match from the beginning of the file.
This option is useful if your text editor
.Pq such as Xr vim 1 or Xr emacs 1
supports jumping directly to a given byte offset/position.
+.Pp
+This is the default behaviour if the
+.Fl L
+option is not provided.
.It Fl c , Fl Fl color
Force colored output,
even if the output device is not a TTY.
@@ -110,12 +114,10 @@ i.e. don’t interpret them as regular expressions.
Report the positions of matches as a (one-based) line- and column
position separated by a colon.
.Pp
-This option is the default behaviour if the
-.Fl b
-option is not supplied,
-but is provided as a means to override the
-.Fl b
-option.
+This option may be ill-advised in many circumstances.
+See
+.Sx BUGS
+for more details.
.It Fl p , Fl Fl predicate
Return an exit status indicating if a match was found without writing any
output to the standard output.
@@ -342,4 +344,11 @@ used to escape the delimeters will be searched for in the text literally.
The pattern string provided as a command-line argument as well as the
provided input files must be encoded as UTF-8.
No other encodings are supported unless they are UTF-8 compatible,
-such as ASCII. \ No newline at end of file
+such as ASCII.
+.Pp
+The
+.Fl L
+option has incredibly poor performance compared to the
+.Fl b
+option,
+especially with very large inputs. \ No newline at end of file