summaryrefslogtreecommitdiffstats
path: root/line-range-format.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2020-11-18 14:15:08 -0800
committerJunio C Hamano <gitster@pobox.com>2020-11-18 14:15:08 -0800
commitb7676d5ada0941ade7ac9acb8ce985686b62b2ab (patch)
tree11ddf24c8178241b09e082064ac45508a805f0e6 /line-range-format.txt
parentee43d18844df1f78dad8b389cbb393b211073d17 (diff)
downloadgit-htmldocs-b7676d5ada0941ade7ac9acb8ce985686b62b2ab.tar.gz
Autogenerated HTML docs for v2.29.2-334-gfaefd
Diffstat (limited to 'line-range-format.txt')
-rw-r--r--line-range-format.txt28
1 files changed, 15 insertions, 13 deletions
diff --git a/line-range-format.txt b/line-range-format.txt
index 829676ff9..9b51e9fb6 100644
--- a/line-range-format.txt
+++ b/line-range-format.txt
@@ -1,30 +1,32 @@
-<start> and <end> can take one of these forms:
+'<start>' and '<end>' can take one of these forms:
- number
+
-If <start> or <end> is a number, it specifies an
+If '<start>' or '<end>' is a number, it specifies an
absolute line number (lines count from 1).
+
-- /regex/
+- `/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
+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>.
+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>.
+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
+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>''
+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.
+from the start of file. `^:<funcname>` searches from the start of
+file. The function names are determined in the same way as `git diff`
+works out patch hunk headers (see 'Defining a custom hunk-header'
+in linkgit:gitattributes[5]).