git/Documentation/gitk.txt, branch v2.32.2

doc: log, gitk: move '-L' description to 'line-range-options.txt'

2020-11-01T23:54:14Z

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 Signed-off-by: Junio C Hamano

doc: log, gitk: line-log arguments must exist in starting revision

2019-12-26T19:00:15Z

The line number, regex or offset parameters and in `git log -L ,:`, or the function name regex in `git log -L ::` must exist in the starting revision, or else the command exits with a fatal error. This is not obvious in the documentation, so add a note to that effect. Signed-off-by: Philippe Blain Signed-off-by: Junio C Hamano

doc: log, gitk: document accepted line-log diff formats

2019-12-26T19:00:13Z

Currently the line-log functionality (git log -L) only supports displaying patch output (`-p | --patch`, its default behavior) and suppressing it (`-s | --no-patch`). A check was added in the code to that effect in 5314efaea (line-log: detect unsupported formats, 2019-03-10) but the documentation was not updated. Explicitly mention that `-L` implies `-p`, that patch output can be suppressed using `-s`, and that all other diff formats are not allowed. Signed-off-by: Philippe Blain Signed-off-by: Junio C Hamano

doc: format pathnames and URLs as monospace.

2019-03-13T02:14:22Z

Applying CodingGuidelines about monospace on pathnames and URLs. See Documentation/CodingGuidelines.txt for more information. Signed-off-by: Corentin BOMPARD Signed-off-by: Nathan BERBEZIER Signed-off-by: Pablo CHABANNE Signed-off-by: Matthieu MOY Signed-off-by: Junio C Hamano

doc: convert [\--] to [--]

2018-04-18T03:49:26Z

Commit 1c262bb7b (doc: convert \--option to --option, 2015-05-13) explains that we used to need to write \--option to play well with older versions of AsciiDoc, but that we do not support such versions anymore anyway, and that Asciidoctor literally renders \--. With [\--], which is used to denote the optional separator between revisions and paths, Asciidoctor renders the backslash literally. Change all [\--] to [--]. This changes nothing for AsciiDoc version 8.6.9, but is an improvement for Asciidoctor version 1.5.4. We use double-dashes in several list entries (\--::). In my testing, it appears that we do need to use the backslash there, so leave those. Signed-off-by: Martin Ågren

Merge branch 'sb/remove-gitview'

2017-01-18T23:12:18Z

Retire long unused/unmaintained gitview from the contrib/ area. * sb/remove-gitview: doc: git-gui browser does not default to HEAD doc: gitk: add the upstream repo location doc: gitk: remove gitview reference contrib: remove gitview

doc: gitk: add the upstream repo location

2017-01-13T20:22:43Z

Match the 'git gui' information regarding the graphical browser and its upstream location. Signed-off-by: Philip Oakley Reviewed-by: Johannes Schindelin Signed-off-by: Junio C Hamano

doc: gitk: remove gitview reference

2017-01-13T20:22:41Z

contrib/gitview has been removed. Remove the reference. Signed-off-by: Philip Oakley Reviewed-by: Johannes Schindelin Signed-off-by: Junio C Hamano

Merge branch 'po/range-doc'

2016-09-09T04:49:49Z

Clarify various ways to specify the "revision ranges" in the documentation. * po/range-doc: doc: revisions: sort examples and fix alignment of the unchanged doc: revisions: show revision expansion in examples doc: revisions - clarify reachability examples doc: revisions - define `reachable` doc: gitrevisions - clarify 'latter case' is revision walk doc: gitrevisions - use 'reachable' in page description doc: revisions: single vs multi-parent notation comparison doc: revisions: extra clarification of ^! notation effects doc: revisions: give headings for the two and three dot notations doc: show the actual left, right, and boundary marks doc: revisions - name the left and right sides doc: use 'symmetric difference' consistently

doc: use 'symmetric difference' consistently

2016-07-20T22:15:16Z

Signed-off-by: Philip Oakley Signed-off-by: Junio C Hamano