X-Git-Url: https://git.tokkee.org/?p=tig.git;a=blobdiff_plain;f=tigrc.5.txt;h=1464492c17fc4ca293f09811c7e387ea99b1ad04;hp=d33056a4f52013efd88a69413de534873a96faef;hb=43fec2264a6cdffc083123ef412d79c95ec44371;hpb=542e6b1ab290b6ae628a55e6106273b6ea46dcaf diff --git a/tigrc.5.txt b/tigrc.5.txt index d33056a..1464492 100644 --- a/tigrc.5.txt +++ b/tigrc.5.txt @@ -49,6 +49,7 @@ set show-line-numbers = no # Show line numbers? set line-number-interval = 5 # Interval between line numbers set commit-encoding = "UTF-8" # Commit encoding set horizontal-scroll = 33% # Scroll 33% of the view width +set blame-options = -C -C -C # Blame lines from other files -------------------------------------------------------------------------- Or in the git configuration files: @@ -86,31 +87,26 @@ Variables The following variables can be set: -'show-rev-graph' (bool):: -'show-refs' (bool):: - - Whether to show revision graph, and references (branches, tags, and - remotes) in the main view on start-up. Can all be toggled. +'author-width' (int):: -'show-author' (mixed) ["abbreviated" | "default" | bool]:: + Width of the author column. When set to 5 or below, the author name + will be abbreviated to the author's initials. - How to display author names. If set to "abbreviated" author initials - will be shown. Can be toggled. +'blame-options' (string):: -'show-date' (mixed) ["relative" | "short" | "default" | bool]:: + A space separated string of extra blame options. Can be used for + telling git-blame(1) how to detect the origin of lines. The value + is ignored when tig is started in blame mode and given blame options + on the command line. - Whether and how to show date. If set to "relative" a relative date will be - used, e.g. "2 minutes ago". If set to "short" no time information is - shown. Can be toggled. - -'author-width' (int):: +'commit-encoding' (string):: - Width of the author column. When set to 5 or below, the author name - will be abbreviated to the author's initials. + The encoding used for commits. The default is UTF-8. Note this option + is shadowed by the "i18n.commitencoding" option in `.git/config`. -'line-graphics' (bool):: +'line-graphics' (mixed) [ "ascii" | "default" | "utf-8" | bool]:: - Whether to use graphic characters for line drawing. + What type of character graphics for line drawing. 'line-number-interval' (int):: @@ -118,10 +114,6 @@ The following variables can be set: numbering with 'n' or the `-n` command line option. The default is to number every line. -'tab-size' (int):: - - Number of spaces per tab. The default is 8 spaces. - 'horizontal-scroll' (mixed):: Interval to scroll horizontally in each step. Can be specified either @@ -130,6 +122,27 @@ The following variables can be set: always ensured that at least one column is scrolled. The default is to scroll '50%' of the view width. +'show-author' (mixed) ["abbreviated" | "default" | bool]:: + + How to display author names. If set to "abbreviated" author initials + will be shown. Can be toggled. + +'show-date' (mixed) ["relative" | "short" | "default" | "local" | bool]:: + + Whether and how to show date. If set to "relative" a relative date will be + used, e.g. "2 minutes ago". If set to "short" no time information is + shown. If set to "local", localtime(3) is used. Can be toggled. + +'show-refs' (bool):: + + Whether to show references (branches, tags, and remotes) in the main + view on start-up. Can be toggled. + +'show-rev-graph' (bool):: + + Whether to show revision graph in the main view on start-up. + Can be toggled. See also line-graphics options. + 'split-view-height' (mixed):: Height of the lower view in a split view. Can be specified either as @@ -138,10 +151,14 @@ The following variables can be set: smaller of the views is at least four rows high. The default is a view height of '66%'. -'commit-encoding' (string):: +'status-untracked-dirs' (bool):: - The encoding used for commits. The default is UTF-8. Not this option - is shadowed by the "i18n.commitencoding" option in `.git/config`. + Show untracked directories contents in the status view (analog to + `git ls-files --directory` option. On by default. + +'tab-size' (int):: + + Number of spaces per tab. The default is 8 spaces. Bind command ------------ @@ -222,10 +239,14 @@ are: |%(head) |The currently viewed 'head' ID. Defaults to HEAD |%(commit) |The currently selected commit ID. |%(blob) |The currently selected blob ID. +|%(branch) |The currently selected branch name. |%(directory) |The current directory path in the tree view; 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. |============================================================================= As an example, the following external command will save the current commit as @@ -300,6 +321,7 @@ put in either the .gitconfig or .git/config file: |scroll-line-down |Scroll one line down |scroll-page-up |Scroll one page up |scroll-page-down |Scroll one page down +|scroll-first-col |Scroll to the first column |scroll-left |Scroll one column left |scroll-right |Scroll one column right |============================================================================= @@ -326,6 +348,7 @@ put in either the .gitconfig or .git/config file: |toggle-date |Toggle date display |toggle-author |Toggle author display |toggle-rev-graph |Toggle revision graph visualization +|toggle-graphic |Toggle (line) graphics mode |toggle-refs |Toggle reference display |edit |Open in editor |none |Do nothing @@ -486,9 +509,9 @@ omnipresent. Commit message:: -For now only `Signed-off-by` and `Acked-by` lines are colorized. +`Signed-off-by`, `Acked-by`, `Reviewed-by` and `Tested-by` lines are colorized. -*signoff*, *acked* +*signoff*, *acked*, *reviewed*, *tested* Tree markup::