git/Documentation/line-range-format.txt
Philippe Blain fd5c74e781 doc: line-range: improve formatting
Improve the formatting of the description of the line-range option '-L'
for `git log`, `gitk` and `git blame`:

- Use bold for <start>, <end> and <funcname>
- Use backticks for literals

Signed-off-by: Philippe Blain <levraiphilippeblain@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2020-11-01 15:54:14 -08:00

31 lines
1,002 B
Plaintext

'<start>' and '<end>' can take one of these forms:
- number
+
If '<start>' or '<end>' is a number, it specifies an
absolute line number (lines count from 1).
+
- `/regex/`
+
This form will use the first line matching the given
POSIX regex. If '<start>' is a regex, it will search from the end of
the previous `-L` range, if any, otherwise from the start of file.
If '<start>' is `^/regex/`, it will search from the start of file.
If '<end>' is a regex, it will search
starting at the line given by '<start>'.
+
- +offset or -offset
+
This is only valid for '<end>' and will specify a number
of lines before or after the line given by '<start>'.
+
If `:<funcname>` is given in place of '<start>' and '<end>', it is a
regular expression that denotes the range from the first funcname line
that matches '<funcname>', up to the next funcname line. `:<funcname>`
searches from the end of the previous `-L` range, if any, otherwise
from the start of file. `^:<funcname>` searches from the start of
file.