summaryrefslogtreecommitdiff
path: root/Documentation/line-range-options.txt
diff options
context:
space:
mode:
authorPhilippe Blain <levraiphilippeblain@gmail.com>2020-11-01 17:28:40 (GMT)
committerJunio C Hamano <gitster@pobox.com>2020-11-01 23:54:14 (GMT)
commitf9c8d8cbbea9cc55d26058a1de767731600ded44 (patch)
treeecf824c24f68e095a87b61dd3e378d18a6c3a033 /Documentation/line-range-options.txt
parente2850a27a95c6f5b141dd88398b1702d2e524a81 (diff)
downloadgit-f9c8d8cbbea9cc55d26058a1de767731600ded44.zip
git-f9c8d8cbbea9cc55d26058a1de767731600ded44.tar.gz
git-f9c8d8cbbea9cc55d26058a1de767731600ded44.tar.bz2
doc: log, gitk: move '-L' description to 'line-range-options.txt'
The description of the '-L' option for `git log` and `gitk` is almost the same, but is repeated in both 'git-log.txt' and 'gitk.txt' (the difference being that 'git-log.txt' lists the option with a space after '-L', while 'gitk.txt' lists it as stuck and notes that `gitk` only understands the stuck form). Reduce duplication by creating a new file, 'line-range-options.txt', and include it in both files. To simplify the presentation, only list the stuck form for both commands, and remove the note about `gitk` only understanding the stuck form. Signed-off-by: Philippe Blain <levraiphilippeblain@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/line-range-options.txt')
-rw-r--r--Documentation/line-range-options.txt15
1 files changed, 15 insertions, 0 deletions
diff --git a/Documentation/line-range-options.txt b/Documentation/line-range-options.txt
new file mode 100644
index 0000000..266263f
--- /dev/null
+++ b/Documentation/line-range-options.txt
@@ -0,0 +1,15 @@
+-L<start>,<end>:<file>::
+-L:<funcname>:<file>::
+
+ Trace the evolution of the line range given by "<start>,<end>"
+ (or the function name regex <funcname>) within the <file>. You may
+ not give any pathspec limiters. This is currently limited to
+ a walk starting from a single revision, i.e., you may only
+ give zero or one positive revision arguments, and
+ <start> and <end> (or <funcname>) must exist in the starting revision.
+ You can specify this option more than once. Implies `--patch`.
+ Patch output can be suppressed using `--no-patch`, but other diff formats
+ (namely `--raw`, `--numstat`, `--shortstat`, `--dirstat`, `--summary`,
+ `--name-only`, `--name-status`, `--check`) are not currently implemented.
++
+include::line-range-format.txt[]