summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 71f547b)
raw | patch | inline | side by side (parent: 71f547b)
author | Jonas Fonseca <fonseca@diku.dk> | |
Wed, 18 Nov 2009 02:24:44 +0000 (21:24 -0500) | ||
committer | Jonas Fonseca <fonseca@diku.dk> | |
Wed, 18 Nov 2009 03:27:32 +0000 (22:27 -0500) |
Also, fix README.html dependencies.
INSTALL | patch | blob | history | |
Makefile | patch | blob | history | |
manual.txt | patch | blob | history | |
tigrc.5.txt | patch | blob | history |
index 7759326a5d1dfc4b1da564ca43a306169842e5e8..a79a3d5b0e6d2e500be8bff9d31e82d7b41ad6c6 100644 (file)
--- a/INSTALL
+++ b/INSTALL
The following tools and packages are needed:
-`-------------------------------`----------------------------------------------
-Tool Description
--------------------------------------------------------------------------------
-git-core Tig is just a frontend for git.
-ncurses Be sure to also have development files \
- installed. Usually they are available in a \
- separate package ending with `-dev`.
-iconv If iconv is not provided by the c library \
- you need to change the Makefile to link it \
- into the binary.
--------------------------------------------------------------------------------
+[cols="2<,8<",options="header"]
+|=============================================================================
+|Tool |Description
+|git-core |Tig is just a frontend for git.
+|ncurses |Be sure to also have development files
+ installed. Usually they are available in a
+ separate package ending with `-dev`.
+|iconv |If iconv is not provided by the c library
+ you need to change the Makefile to link it
+ into the binary.
+|=============================================================================
The following optional tools and packages are needed for creating the
configure script and building documentation:
-`-------------------------------`----------------------------------------------
-autoconf Contains autoreconf for generating configure \
- from configure.ac.
-asciidoc (>= 8.0) Generates HTML and (DocBook) XML from text.
-xmlto Generates manpages and chunked HTML from XML.
-DocBook XSL (>= 1.72.0) Used by xmlto for building manpages.
-DocBook (DSSL/Jade) tools Generates PDF from XML. \
+[cols="2<,8<",options="header"]
+|=============================================================================
+|Tool |Description
+|autoconf |Contains autoreconf for generating configure
+ from configure.ac.
+|asciidoc (>= 8.0) |Generates HTML and (DocBook) XML from text.
+|xmlto |Generates manpages and chunked HTML from XML.
+|DocBook XSL (>= 1.72.0) |Used by xmlto for building manpages.
+|DocBook (DSSL/Jade) tools |Generates PDF from XML.
Also known as docbook-utils.
--------------------------------------------------------------------------------
+|=============================================================================
diff --git a/Makefile b/Makefile
index d764644ba99bde58ec46ad0acc682088e69b1d8a..8688eb5bba268aec524cc0fc54e5efc4a63e0e98 100644 (file)
--- a/Makefile
+++ b/Makefile
*) ref="$$ref, $$line" ;; \
esac; done | sed 's/\[\[\(.*\)\]\]/\1/' > $@
-README.html: README asciidoc.conf
+README.html: README SITES INSTALL asciidoc.conf
$(ASCIIDOC) $(ASCIIDOC_FLAGS) -b xhtml11 -d article -a readme $<
NEWS.html: NEWS asciidoc.conf
diff --git a/manual.txt b/manual.txt
index d73e819ed2aab5455514276dac07200aa6576969..559c34524881cee0d259b3d0d6cccc1c1af5dbe1 100644 (file)
--- a/manual.txt
+++ b/manual.txt
shell.
NOTE: If you specify options for the main view, you should not use the
-`\--pretty` option as this option will be set automatically to the format
+`--pretty` option as this option will be set automatically to the format
expected by the main view.
Example on how to view a commit and show both author and committer
arguments that refer to the current browsing state by using one of the
following variables.
-`-----------------------`-----------------------------------------------------
-Browsing state variables
-------------------------------------------------------------------------------
-%(head) The currently viewed 'head' ID. Defaults to HEAD
-%(commit) The currently selected commit ID.
-%(blob) The currently selected blob ID.
-%(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.
-------------------------------------------------------------------------------
+.Browsing state variables
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|%(head) |The currently viewed 'head' ID. Defaults to HEAD
+|%(commit) |The currently selected commit ID.
+|%(blob) |The currently selected blob ID.
+|%(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.
+|=============================================================================
[[title-window]]
Title Windows
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:
+ `--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
+ the option: `--pretty=raw` since the main view parser expects to
read that format.
-----------------------------------------------------------------------------
git log --no-color --pretty=raw --parents --topo-order %(head)
View Switching
~~~~~~~~~~~~~~
-`-------`--------------------------------------------------------------------
-Key Action
------------------------------------------------------------------------------
-m Switch to main view.
-d Switch to diff view.
-l Switch to log view.
-p Switch to pager view.
-t Switch to (directory) tree view.
-f Switch to (file) blob view.
-B Switch to blame view.
-H Switch to branch view.
-h Switch to help view
-S Switch to status view
-c Switch to stage view
------------------------------------------------------------------------------
+[frame="none",grid="none",cols="2<,8<",options="header"]
+|=============================================================================
+|Key |Action
+|m |Switch to main view.
+|d |Switch to diff view.
+|l |Switch to log view.
+|p |Switch to pager view.
+|t |Switch to (directory) tree view.
+|f |Switch to (file) blob view.
+|B |Switch to blame view.
+|H |Switch to branch view.
+|h |Switch to help view
+|S |Switch to status view
+|c |Switch to stage view
+|=============================================================================
[[view-manipulation]]
View Manipulation
~~~~~~~~~~~~~~~~~
-`-------`--------------------------------------------------------------------
-Key Action
------------------------------------------------------------------------------
-q Close view, if multiple views are open it will jump back to the \
- previous view in the view stack. If it is the last open view it \
+[frame="none",grid="none",cols="2<,8<",options="header"]
+|=============================================================================
+|Key |Action
+|q |Close view, if multiple views are open it will jump back to the
+ previous view in the view stack. If it is the last open view it
will quit. Use 'Q' to quit all views at once.
-Enter This key is "context sensitive" depending on what view you are \
- currently in. When in log view on a commit line or in the main \
- view, split the view and show the commit diff. In the diff view \
+|Enter |This key is "context sensitive" depending on what view you are
+ currently in. When in log view on a commit line or in the main
+ view, split the view and show the commit diff. In the diff view
pressing Enter will simply scroll the view one line down.
-Tab Switch to next view.
-R Reload and refresh the current view.
-M Maximize the current view to fill the whole display.
-Up This key is "context sensitive" and will move the cursor one \
- line up. However, if you opened a diff view from the main view \
- (split- or full-screen) it will change the cursor to point to \
- the previous commit in the main view and update the diff view \
+|Tab |Switch to next view.
+|R |Reload and refresh the current view.
+|M |Maximize the current view to fill the whole display.
+|Up |This key is "context sensitive" and will move the cursor one
+ line up. However, if you opened a diff view from the main view
+ (split- or full-screen) it will change the cursor to point to
+ the previous commit in the main view and update the diff view
to display it.
-Down Similar to 'Up' but will move down.
-',' Move to parent. In the tree view, this means switch to the parent \
- directory. In the blame view it will load blame for the parent \
+|Down |Similar to 'Up' but will move down.
+|, |Move to parent. In the tree view, this means switch to the parent
+ directory. In the blame view it will load blame for the parent
commit. For merges the parent is queried.
------------------------------------------------------------------------------
+|=============================================================================
[[view-actions]]
View Specific Actions
~~~~~~~~~~~~~~~~~~~~~
-`-------`--------------------------------------------------------------------
-Key Action
------------------------------------------------------------------------------
-u Update status of file. In the status view, this allows you to add an \
- untracked file or stage changes to a file for next commit (similar to \
- running git-add <filename>). In the stage view, when pressing this on \
- a diff chunk line stages only that chunk for next commit, when not on \
- a diff chunk line all changes in the displayed diff is staged.
-M Resolve unmerged file by launching git-mergetool(1). Note, to work \
- correctly this might require some initial configuration of your \
- preferred merge tool. See the manpage of git-mergetool(1).
-! Checkout file with unstaged changes. This will reset the file to \
- contain the content it had at last commit.
-@ Move to next chunk in the stage view.
------------------------------------------------------------------------------
+[frame="none",grid="none",cols="2<,8<",options="header"]
+|=============================================================================
+|Key |Action
+|u |Update status of file. In the status view, this allows you to add an
+ untracked file or stage changes to a file for next commit (similar to
+ running git-add <filename>). In the stage view, when pressing this on
+ a diff chunk line stages only that chunk for next commit, when not on
+ a diff chunk line all changes in the displayed diff is staged.
+|M |Resolve unmerged file by launching git-mergetool(1). Note, to work
+ correctly this might require some initial configuration of your
+ preferred merge tool. See the manpage of git-mergetool(1).
+|! |Checkout file with unstaged changes. This will reset the file to
+ contain the content it had at last commit.
+|@ |Move to next chunk in the stage view.
+|=============================================================================
[[cursor-nav]]
Cursor Navigation
~~~~~~~~~~~~~~~~~
-`-------`--------------------------------------------------------------------
-Key Action
------------------------------------------------------------------------------
-k Move cursor one line up.
-j Move cursor one line down.
-PgUp,\
--,a Move cursor one page up.
-PgDown Space Move cursor one page down.
-Home Jump to first line.
-End Jump to last line.
------------------------------------------------------------------------------
+[frame="none",grid="none",cols="2<,8<",options="header"]
+|=============================================================================
+|Key |Action
+|k |Move cursor one line up.
+|j |Move cursor one line down.
+|PgUp,-,a |Move cursor one page up.
+|PgDown, Space |Move cursor one page down.
+|End |Jump to last line.
+|Home |Jump to first line.
+|=============================================================================
[[view-scrolling]]
Scrolling
~~~~~~~~~
-`-------`--------------------------------------------------------------------
-Key Action
------------------------------------------------------------------------------
-Insert Scroll view one line up.
-Delete Scroll view one line down.
-w Scroll view one page up.
-s Scroll view one page down.
-Left Scroll view one column left.
-Right Scroll view one column right.
------------------------------------------------------------------------------
+[frame="none",grid="none",cols="2<,8<",options="header"]
+|=============================================================================
+|Key |Action
+|Insert |Scroll view one line up.
+|Delete |Scroll view one line down.
+|w |Scroll view one page up.
+|s |Scroll view one page down.
+|Left |Scroll view one column left.
+|Right |Scroll view one column right.
+|=============================================================================
[[searching]]
Searching
~~~~~~~~~
-`-------`--------------------------------------------------------------------
-Key Action
------------------------------------------------------------------------------
-/ Search the view. Opens a prompt for entering search regexp to use.
-? Search backwards in the view. Also prompts for regexp.
-n Find next match for the current search regexp.
-N Find previous match for the current search regexp.
------------------------------------------------------------------------------
+[frame="none",grid="none",cols="2<,8<",options="header"]
+|=============================================================================
+|Key |Action
+|/ |Search the view. Opens a prompt for entering search regexp to use.
+|? |Search backwards in the view. Also prompts for regexp.
+|n |Find next match for the current search regexp.
+|N |Find previous match for the current search regexp.
+|=============================================================================
[[misc-keys]]
Misc
~~~~
-`-------`--------------------------------------------------------------------
-Key Action
------------------------------------------------------------------------------
-Q Quit.
-r Redraw screen.
-z Stop all background loading. This can be useful if you use \
- tig in a repository with a long history without limiting \
- the revision log.
-v Show version.
-o Open option menu
-'.' Toggle line numbers on/off.
-D Toggle date display on/off.
-A Toggle author display on/off.
-g Toggle revision graph visualization on/off.
-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 \
- to a specific line by typing `:<linenumber>`, e.g. `:80`.
-e Open file in editor.
------------------------------------------------------------------------------
+[frame="none",grid="none",cols="2<,8<",options="header"]
+|=============================================================================
+|Key |Action
+|Q |Quit.
+|r |Redraw screen.
+|z |Stop all background loading. This can be useful if you use
+ tig in a repository with a long history without limiting
+ the revision log.
+|v |Show version.
+|o |Open option menu
+|. |Toggle line numbers on/off.
+|D |Toggle date display on/off.
+|A |Toggle author display on/off.
+|g |Toggle revision graph visualization on/off.
+|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
+ to a specific line by typing `:<linenumber>`, e.g. `:80`.
+|e |Open file in editor.
+|=============================================================================
[[external-commands]]
External Commands
current browsing state, such as the current commit ID. Tig comes with
the following built-in external commands:
-`-------`-------`------------------------------------------------------------
-Keymap Key Action
------------------------------------------------------------------------------
-main C git cherry-pick %(commit)
-status C git commit
-generic G git gc
------------------------------------------------------------------------------
+[frame="none",grid="none",cols="1<,1<,8<",options="header"]
+|=============================================================================
+|Keymap |Key |Action
+|main |C |git cherry-pick %(commit)
+|status |C |git commit
+|generic|G |git gc
+|=============================================================================
[[refspec]]
Revision Specification
-----------------------------------------------------------------------------
To avoid ambiguity with tig's subcommands or repository references such as tag
-name, be sure to separate file names from other git options using "\--". So if
+name, be sure to separate file names from other git options using "`--`". So if
you have a file named 'status' it will clash with the 'status' subcommand, and
thus you will have to use:
To speed up interaction with git, you can limit the amount of commits to show
both for the log and main view. Either limit by date using e.g.
-`\--since=1.month` or limit by the number of commits using `-n400`.
+`--since=1.month` or limit by the number of commits using `-n400`.
If you are only interested in changed that happened between two dates you can
use:
-----------------------------------------------------------------------------
NOTE: If you want to avoid having to quote dates containing spaces you can use
-"." instead, e.g. `\--after=May.5th`.
+"." instead, e.g. `--after=May.5th`.
[[commit-range-limiting]]
Limiting by Commit Ranges
Online resources:
include::SITES[]
-
-Other git repository browsers:
-
- - gitk(1)
- - qgit(1)
diff --git a/tigrc.5.txt b/tigrc.5.txt
index 3ead320ee54e3bc4d05f4526e1ea226cf22595f8..711c6a48e91632bf4294c1ab830e8173675e8571 100644 (file)
--- a/tigrc.5.txt
+++ b/tigrc.5.txt
names that will be substituted before the command is run. Valid variable names
are:
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-Browsing state variables
-------------------------------------------------------------------------------
-%(head) The currently viewed 'head' ID. Defaults to HEAD
-%(commit) The currently selected commit ID.
-%(blob) The currently selected blob ID.
-%(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.
-------------------------------------------------------------------------------
+.Browsing state variables
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|%(head) |The currently viewed 'head' ID. Defaults to HEAD
+|%(commit) |The currently selected commit ID.
+|%(blob) |The currently selected blob ID.
+|%(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.
+|=============================================================================
As an example, the following external command will save the current commit as
a patch file: "!git format-patch -1 %(commit)". If your external command
generic = > !git publish
--------------------------------------------------------------------------
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-View switching:
-------------------------------------------------------------------------------
-view-main Show main view
-view-diff Show diff view
-view-log Show log view
-view-tree Show tree view
-view-blob Show blob view
-view-blame Show blame view
-view-branch Show branch view
-view-status Show status view
-view-stage Show stage view
-view-pager Show pager view
-view-help Show help page
-------------------------------------------------------------------------------
-
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-View manipulation:
-------------------------------------------------------------------------------
-enter Enter current line and scroll
-next Move to next
-previous Move to previous
-parent Move to parent
-view-next Move focus to next view
-refresh Reload and refresh view
-maximize Maximize the current view
-view-close Close the current view
-quit Close all views and quit
-------------------------------------------------------------------------------
-
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-View specific actions:
-------------------------------------------------------------------------------
-status-update Update file status
-status-merge Resolve unmerged file
-stage-next Find next chunk to stage
-------------------------------------------------------------------------------
-
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-Cursor navigation:
-------------------------------------------------------------------------------
-move-up Move cursor one line up
-move-down Move cursor one line down
-move-page-down Move cursor one page down
-move-page-up Move cursor one page up
-move-first-line Move cursor to first line
-move-last-line Move cursor to last line
-------------------------------------------------------------------------------
-
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-Scrolling:
-------------------------------------------------------------------------------
-scroll-line-up Scroll one line up
-scroll-line-down Scroll one line down
-scroll-page-up Scroll one page up
-scroll-page-down Scroll one page down
-scroll-left Scroll one column left
-scroll-right Scroll one column right
-------------------------------------------------------------------------------
-
-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"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-Misc:
-------------------------------------------------------------------------------
-prompt Bring up the prompt
-screen-redraw Redraw the screen
-screen-resize Resize the screen
-show-version Show version information
-stop-loading Stop all loading views
-options Open options menu
-toggle-lineno Toggle line numbers
-toggle-date Toggle date display
-toggle-author Toggle author display
-toggle-rev-graph Toggle revision graph visualization
-toggle-refs Toggle reference display
-edit Open in editor
-none Do nothing
-------------------------------------------------------------------------------
+.View switching
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|view-main |Show main view
+|view-diff |Show diff view
+|view-log |Show log view
+|view-tree |Show tree view
+|view-blob |Show blob view
+|view-blame |Show blame view
+|view-branch |Show branch view
+|view-status |Show status view
+|view-stage |Show stage view
+|view-pager |Show pager view
+|view-help |Show help page
+|=============================================================================
+
+.View manipulation
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|enter |Enter current line and scroll
+|next |Move to next
+|previous |Move to previous
+|parent |Move to parent
+|view-next |Move focus to next view
+|refresh |Reload and refresh view
+|maximize |Maximize the current view
+|view-close |Close the current view
+|quit |Close all views and quit
+|=============================================================================
+
+.View specific actions
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|status-update |Update file status
+|status-merge |Resolve unmerged file
+|stage-next |Find next chunk to stage
+|=============================================================================
+
+.Cursor navigation
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|move-up |Move cursor one line up
+|move-down |Move cursor one line down
+|move-page-down |Move cursor one page down
+|move-page-up |Move cursor one page up
+|move-first-line |Move cursor to first line
+|move-last-line |Move cursor to last line
+|=============================================================================
+
+.Scrolling
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|scroll-line-up |Scroll one line up
+|scroll-line-down |Scroll one line down
+|scroll-page-up |Scroll one page up
+|scroll-page-down |Scroll one page down
+|scroll-left |Scroll one column left
+|scroll-right |Scroll one column right
+|=============================================================================
+
+.Searching
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|search |Search the view
+|search-back |Search backwards in the view
+|find-next |Find next search match
+|find-prev |Find previous search match
+|=============================================================================
+
+.Misc
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|prompt |Bring up the prompt
+|screen-redraw |Redraw the screen
+|screen-resize |Resize the screen
+|show-version |Show version information
+|stop-loading |Stop all loading views
+|options |Open options menu
+|toggle-lineno |Toggle line numbers
+|toggle-date |Toggle date display
+|toggle-author |Toggle author display
+|toggle-rev-graph |Toggle revision graph visualization
+|toggle-refs |Toggle reference display
+|edit |Open in editor
+|none |Do nothing
+|=============================================================================
Color command
that specify the use of the default terminal colors can be controlled by
setting the *default* color option.
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-General:
-------------------------------------------------------------------------------
-default Overwrite default terminal colors (see above).
-cursor The cursor line.
-status The status window showing info messages.
-title-focus The title window for the current view.
-title-blur The title window of any backgrounded view.
-delimiter Delimiter shown for truncated lines.
-line-number Line numbers.
-date The commit date.
-author The commit author.
-mode The file mode holding the permissions and type.
-------------------------------------------------------------------------------
-
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-Main view colors:
-------------------------------------------------------------------------------
-main-revgraph The revision graph.
-main-commit The commit comment.
-main-head Label of the current branch.
-main-remote Label of a remote.
-main-tracked Label of the remote tracked by the current branch.
-main-tag Label of a signed tag.
-main-local-tag Label of a local tag.
-main-ref Label of any other reference.
-------------------------------------------------------------------------------
-
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-Status view:
-------------------------------------------------------------------------------
-stat-head The "On branch"-line.
-stat-section Status section titles,
-stat-staged Status flag of staged files.
-stat-unstaged Status flag of unstaged files.
-stat-untracked Status flag of untracked files.
-------------------------------------------------------------------------------
-
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-Blame view:
-------------------------------------------------------------------------------
-blame-id The commit ID.
-------------------------------------------------------------------------------
-
-ifdef::backend-xhtml11[]
-[frame="none"]
-`-----------------------`-----------------------------------------------------
-endif::backend-xhtml11[]
-Tree view:
-------------------------------------------------------------------------------
-tree-head The "Directory /"-line
-tree-dir The directory name.
-tree-file The file name.
-------------------------------------------------------------------------------
+.General
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|default |Overwrite default terminal colors (see above).
+|cursor |The cursor line.
+|status |The status window showing info messages.
+|title-focus |The title window for the current view.
+|title-blur |The title window of any backgrounded view.
+|delimiter |Delimiter shown for truncated lines.
+|line-number |Line numbers.
+|date |The commit date.
+|author |The commit author.
+|mode |The file mode holding the permissions and type.
+|=============================================================================
+
+.Main view colors
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|main-revgraph |The revision graph.
+|main-commit |The commit comment.
+|main-head |Label of the current branch.
+|main-remote |Label of a remote.
+|main-tracked |Label of the remote tracked by the current branch.
+|main-tag |Label of a signed tag.
+|main-local-tag |Label of a local tag.
+|main-ref |Label of any other reference.
+|=============================================================================
+
+.Status view
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|stat-head |The "On branch"-line.
+|stat-section |Status section titles,
+|stat-staged |Status flag of staged files.
+|stat-unstaged |Status flag of unstaged files.
+|stat-untracked |Status flag of untracked files.
+|=============================================================================
+
+.Blame view
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|blame-id |The commit ID.
+|=============================================================================
+
+.Tree view
+[frame="none",grid="none",cols="25<m,75<"]
+|=============================================================================
+|tree-head |The "Directory /"-line
+|tree-dir |The directory name.
+|tree-file |The file name.
+|=============================================================================
Highlighting
~~~~~~~~~~~~