X-Git-Url: https://git.tokkee.org/?p=tig.git;a=blobdiff_plain;f=manual.txt;h=c9b18932fd98705bff238aa1af9b897094f6a16d;hp=cfc26c67840b68d5054767f2b12a11375a228cb3;hb=HEAD;hpb=7332344186ab02b45babce8299162b1b56ad7cc0 diff --git a/manual.txt b/manual.txt index cfc26c6..c9b1893 100644 --- a/manual.txt +++ b/manual.txt @@ -158,6 +158,9 @@ following variables. empty for the root directory. |%(file) |The currently selected file. |%(ref) |The reference given to blame or HEAD if undefined. +|%(revargs) |The revision arguments passed on the command line. +|%(fileargs) |The file arguments passed on the command line. +|%(diffargs) |The diff options passed on the command line. |============================================================================= [[title-window]] @@ -235,74 +238,19 @@ git ls-remote . -- -[[history-commands]] -History Commands -~~~~~~~~~~~~~~~~ +[[diff-options]] +Diff options +~~~~~~~~~~~~ -It is possible to alter which commands are used for the different views. If -for example you prefer commits in the main view to be sorted by date and only -show 500 commits, use: +It is possible to alter how diffs are shown by the diff view. If for example +you prefer to have commit and author dates shown as relative dates, use: ----------------------------------------------------------------------------- -$ TIG_MAIN_CMD="git log --date-order -n500 --pretty=raw %(head)" tig +$ TIG_DIFF_OPTS="--relative-date" tig ----------------------------------------------------------------------------- Or set the variable permanently in your environment. -Notice, how `%(head)` is used to specify the commit reference. - --- - -TIG_DIFF_CMD:: - - The command used for the diff view. Defaults to: ------------------------------------------------------------------------------ -git show --pretty=fuller --no-color --root - --patch-with-stat --find-copies-harder -C %(commit) ------------------------------------------------------------------------------ - -TIG_LOG_CMD:: - - The command used for the log view. If you prefer to have both - author and committer shown in the log view be sure to pass - `--pretty=fuller` to git log. Defaults to: ------------------------------------------------------------------------------ -git log --no-color --cc --stat -n100 %(head) ------------------------------------------------------------------------------ - -TIG_MAIN_CMD:: - - The command used for the main view. Note, you must always specify - the option: `--pretty=raw` since the main view parser expects to - read that format. ------------------------------------------------------------------------------ -git log --no-color --pretty=raw --parents --topo-order %(head) ------------------------------------------------------------------------------ - --- - -[[tree-commands]] -Tree Commands -~~~~~~~~~~~~~ - --- - -TIG_TREE_CMD:: - - The command used for the tree view. Defaults to: ------------------------------------------------------------------------------ -git ls-tree %(commit) %(directory) ------------------------------------------------------------------------------ - -TIG_BLOB_CMD:: - - The command used for the blob view. Defaults to: ------------------------------------------------------------------------------ -git cat-file blob %(blob) ------------------------------------------------------------------------------ - --- - [[keys]] Default Keybindings ------------------- @@ -404,6 +352,7 @@ Scrolling |s |Scroll view one page down. |Left |Scroll view one column left. |Right |Scroll view one column right. +|\| |Scroll view to the first column. |============================================================================= [[searching]] @@ -434,9 +383,10 @@ Misc |v |Show version. |o |Open option menu |. |Toggle line numbers on/off. -|D |Toggle date display on/off/relative. +|D |Toggle date display on/off/short/relative/local. |A |Toggle author display on/off/abbreviated. |g |Toggle revision graph visualization on/off. +|~ |Toggle (line) graphics mode |F |Toggle reference display on/off (tag and branch names). |: |Open prompt. This allows you to specify what git command to run. Example `:log -p`. You can also use this to jump @@ -472,8 +422,8 @@ information. Relevant man pages besides git-log(1) are git-diff(1) and git-rev-list(1). You can tune the interaction with git by making use of the options explained -in this section. For example, by configuring the environment variables -described in the section on <>. +in this section. For example, by configuring the environment variable +described in the section on <>. [[path-limiting]] Limit by Path Name