From: Jean-Noël Avila via GitGitGadget Date: Sun, 29 Jun 2025 13:20:36 GMT Subject: [PATCH v2 4/9] doc: git-log: convert line range format to new doc format Message-ID: <384a7d23563ade9764a261be5492dc229445a8d0.1751203241.git.gitgitgadget@gmail.com> In-Reply-To: From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= - Use __ instead of in the description - Use `backticks` for keywords and more complex option descriptions. The new rendering engine will apply synopsis rules to these spans. Signed-off-by: Jean-Noël Avila --- Documentation/line-range-format.adoc | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/Documentation/line-range-format.adoc b/Documentation/line-range-format.adoc index 9b51e9fb6614..3cc2a14544cf 100644 --- a/Documentation/line-range-format.adoc +++ b/Documentation/line-range-format.adoc @@ -1,30 +1,30 @@ -'' and '' can take one of these forms: +__ and __ can take one of these forms: -- number +- __ + -If '' or '' is a number, it specifies an +If __ or __ 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 '' is a regex, it will search from the end of +POSIX __. If __ is a regex, it will search from the end of the previous `-L` range, if any, otherwise from the start of file. -If '' is `^/regex/`, it will search from the start of file. -If '' is a regex, it will search -starting at the line given by ''. +If __ is `^//`, it will search from the start of file. +If __ is a regex, it will search starting at the line given by +__. + -- +offset or -offset +- `+` or `-` + -This is only valid for '' and will specify a number -of lines before or after the line given by ''. +This is only valid for __ and will specify a number +of lines before or after the line given by __. + -If `:` is given in place of '' and '', it is a +If `:` is given in place of __ and __, it is a regular expression that denotes the range from the first funcname line -that matches '', up to the next funcname line. `:` +that matches __, up to the next funcname line. `:` searches from the end of the previous `-L` range, if any, otherwise from the start of file. `^:` searches from the start of file. The function names are determined in the same way as `git diff` -- gitgitgadget