Code

Added color option main-revgraph to color the revision graph.
[tig.git] / tigrc.5.txt
index a3bee01f13defe78ab7cd48f3207f536b25a1e44..521880b1051d799edac06008ade61e56e2b3dece 100644 (file)
@@ -44,7 +44,7 @@ Examples:
 --------------------------------------------------------------------------
        set show-rev-graph = yes        # Show revision graph?
        set line-number-interval = 5    # Interval between line numbers
-       set tab-size = 8                # Number of spaces pr tab 
+       set tab-size = 8                # Number of spaces per tab
        set encoding = "UTF-8"          # Commit encoding
 --------------------------------------------------------------------------
 
@@ -112,6 +112,10 @@ Examples:
        bind diff b move-first-line
        # 'unbind' the default quit key binding
        bind main Q none
+       # An external command to update from upstream
+       bind generic F !git fetch
+       # Cherry-pick current commit unto current branch
+       bind generic C !git cherry-pick %(commit)
 --------------------------------------------------------------------------
 
 Keys are mapped by first searching the keybindings for the current view, then
@@ -123,8 +127,8 @@ built-in keybindings.
 
 Keymaps::
 
-Valid keymaps are: *main*, *diff*, *log*, *help*, *pager*, and *generic*.  Use
-*generic* to set key mapping in all keymaps.
+Valid keymaps are: *main*, *diff*, *log*, *help*, *pager*, *status*, *stage*,
+and *generic*.  Use *generic* to set key mapping in all keymaps.
 
 Key values::
 
@@ -148,6 +152,14 @@ e.g. "view-main", "View.Main", and "VIEW_MAIN" are the same.
 Actions
 ~~~~~~~
 
+Apart from the action names listed below, all actions starting with a '!' will
+be available as an external command. External commands can contain variable
+names that will be substituted before the command is run. Valid variable names
+are "%(head)", "%(commit)", and "%(blob)".
+
+As an example, the following external command will save the current commit as
+a patch file: "!git format-patch %(commit)^..%(commit)".
+
 ifdef::backend-xhtml11[]
 [frame="none"]
 `-----------------------`-----------------------------------------------------
@@ -159,6 +171,8 @@ view-diff           Show diff view
 view-log               Show log view
 view-tree              Show tree view
 view-blob              Show blob view
+view-status            Show status view
+view-stage             Show stage view
 view-pager             Show pager view
 view-help              Show help page
 ------------------------------------------------------------------------------
@@ -173,6 +187,7 @@ enter                       Enter current line and scroll
 next                   Move to next
 previous               Move to previous
 view-next              Move focus to next view
+refresh                        Reload and refresh view
 view-close             Close the current view
 quit                   Close all views and quit
 ------------------------------------------------------------------------------
@@ -203,6 +218,18 @@ scroll-page-eup            Scroll one page up
 scroll-page-down       Scroll one page down
 ------------------------------------------------------------------------------
 
+ifdef::backend-xhtml11[]
+[frame="none"]
+`-----------------------`-----------------------------------------------------
+endif::backend-xhtml11[]
+Searching:
+------------------------------------------------------------------------------
+search                 Search the view
+search-back            Search backwards in the view
+find-next              Find next search match
+find-prev              Find previous search match
+------------------------------------------------------------------------------
+
 ifdef::backend-xhtml11[]
 [frame="none"]
 `-----------------------`-----------------------------------------------------
@@ -217,6 +244,9 @@ show-version                Show version information
 stop-loading           Stop all loading views
 toggle-lineno          Toggle line numbers
 toggle-rev-graph       Toggle revision graph visualization
+status-update          Update file status
+status-merge           Resolve unmerged file
+edit                   Open in editor
 ------------------------------------------------------------------------------
 
 
@@ -294,7 +324,7 @@ Appearance of the various columns in the main view, including the '~' used for
 delimiting long author names and labels for tag and branch references.
 
 *main-date*, *main-author*, *main-commit*, *main-delim*, *main-tag*,
-*main-ref*, *main-remote*
+*main-ref*, *main-remote*, *main-revgraph*
 
 --
 
@@ -318,7 +348,7 @@ Extra diff information emitted by the git diff machinery, such as mode
 changes, rename detection, and similarity.
 
 *diff-oldmode*, *diff-newmode*, *diff-copy-from*, *diff-copy-to*,
-*diff-rename-from*, *diff-rename-to*, *diff-similarity* *diff-dissimilarity*
+*diff-rename-from*, *diff-rename-to*, *diff-similarity*, *diff-dissimilarity*
 *diff-tree*, *diff-index*
 
 Pretty print commit headers::
@@ -327,7 +357,8 @@ Commit diffs and the revision logs are usually formatted using pretty printed
 headers , unless `--pretty=raw` was given. This includes lines, such as merge
 info, commit ID, and author and committer date.
 
-*pp-author*, *pp-commit*, *pp-merge*, *pp-date*, *pp-adate*, *pp-cdate*
+*pp-author*, *pp-commit*, *pp-merge*, *pp-date*, *pp-adate*, *pp-cdate*,
+*pp-refs*
 
 Raw commit header::
 
@@ -342,11 +373,23 @@ For now only `Signed-off-by` and `Acked-by` lines are colorized.
 
 *signoff*, *acked*
 
+Tree markup::
+
+Colors for information of the tree view.
+
+*tree-dir*, *tree-file*
+
+Status markup::
+
+Colors used in the status view.
+
+*stat-section*, *stat-none*, *stat-staged*, *stat-unstaged*, *stat-untracked*
+
 --
 
 COPYRIGHT
 ---------
-Copyright (c) 2006 Jonas Fonseca <fonseca@diku.dk>
+Copyright (c) 2006-2007 Jonas Fonseca <fonseca@diku.dk>
 
 Licensed under the terms of the GNU General Public License.