X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=tigrc.5.txt;h=649a47ae7d04a495c523c5ee32028d054f2a1c8c;hb=21afe1d8fec56dec24297124594cb8abc3621169;hp=be9bf8dbf8f008428a04338d23b1bb6e42ac9f2f;hpb=157ebf5433e98ddca88fcec4319bcaf510cfc4ad;p=tig.git diff --git a/tigrc.5.txt b/tigrc.5.txt index be9bf8d..649a47a 100644 --- a/tigrc.5.txt +++ b/tigrc.5.txt @@ -41,7 +41,7 @@ is: Examples: -------------------------------------------------------------------------- -set show-author = yes # Show author? +set show-author = abbreviated # Show abbreviated author names. set show-date = relative # Show relative commit date. set show-rev-graph = yes # Show revision graph? set show-refs = yes # Show references? @@ -86,28 +86,19 @@ Variables The following variables can be set: -'show-author' (bool):: -'show-rev-graph' (bool):: -'show-refs' (bool):: - - Whether to show author, revision graph, and references - (branches, tags, and remotes) in the main view on start-up. Can all be - toggled. - -'show-date' (bool or "relative" or "short"):: - - 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):: Width of the author column. When set to 5 or below, the author name will be abbreviated to the author's initials. -'line-graphics' (bool):: +'commit-encoding' (string):: - Whether to use graphic characters for line drawing. + 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' (mixed) [ "ascii" | "default" | "utf-8" | bool]:: + + What type of character graphics for line drawing. 'line-number-interval' (int):: @@ -115,10 +106,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 @@ -127,6 +114,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 @@ -135,10 +143,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 ------------ @@ -219,10 +231,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 @@ -297,6 +313,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 |============================================================================= @@ -323,6 +340,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 @@ -483,9 +501,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:: @@ -497,7 +515,7 @@ Colors for information of the tree view. COPYRIGHT --------- -Copyright (c) 2006-2009 Jonas Fonseca +Copyright (c) 2006-2010 Jonas Fonseca Licensed under the terms of the GNU General Public License.