<a href="#view-scrolling">Scrolling</a>\r
</p>\r
</li>\r
+<li>\r
+<p>\r
+<a href="#searching">Searching</a>\r
+</p>\r
+</li>\r
</ul>\r
</li>\r
<li>\r
by pressing <em>Tab</em>. To maximize the log view again, simply press <em>l</em>.</p>\r
<h3><a id="commit-id"></a>3.1. Current Head and Commit ID</h3>\r
<p>The viewer keeps track of both what head and commit ID you are currently\r
-viewing. The commit ID will follow the cursor line and change everytime time\r
+viewing. The commit ID will follow the cursor line and change every time\r
you highlight a different commit. Whenever you reopen the diff view it will be\r
reloaded, if the commit ID changed.</p>\r
<p>The head ID is used when opening the main and log view to indicate from what\r
</p>\r
</dd>\r
<dt>\r
+The tree view\r
+</dt>\r
+<dd>\r
+<p>\r
+ Lists directory trees associated with the current revision allowing\r
+ subdirectories to be descended or ascended and file blobs to be\r
+ viewed.\r
+</p>\r
+</dd>\r
+<dt>\r
+The blob view\r
+</dt>\r
+<dd>\r
+<p>\r
+ Displays the file content or "blob" of data associated with a file\r
+ name.\r
+</p>\r
+</dd>\r
+<dt>\r
The pager view\r
</dt>\r
<dd>\r
</tr>\r
<tr>\r
<td align="left">\r
- h, ?\r
+ t\r
+ </td>\r
+ <td align="left">\r
+ Switch to (directory) tree view.\r
+ </td>\r
+ </tr>\r
+ <tr>\r
+ <td align="left">\r
+ f\r
+ </td>\r
+ <td align="left">\r
+ Switch to (file) blob view.\r
+ </td>\r
+ </tr>\r
+ <tr>\r
+ <td align="left">\r
+ h\r
</td>\r
<td align="left">\r
Show man page.\r
Up\r
</td>\r
<td align="left">\r
- This key is "context sensitive" and will move the cursor one line up. However, uf 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.\r
+ 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.\r
</td>\r
</tr>\r
<tr>\r
</tbody>\r
</table>\r
</div>\r
-<h3><a id="misc-keys"></a>4.5. Misc</h3>\r
+<h3><a id="searching"></a>4.5. Searching</h3>\r
+<div class="tableblock">\r
+<table rules="none"\r
+frame="hsides"\r
+cellspacing="0" cellpadding="4">\r
+<col width="91" />\r
+<col width="788" />\r
+<thead>\r
+ <tr>\r
+ <th align="left">\r
+ Key\r
+ </th>\r
+ <th align="left">\r
+ Action\r
+ </th>\r
+ </tr>\r
+</thead>\r
+<tbody valign="top">\r
+ <tr>\r
+ <td align="left">\r
+ /\r
+ </td>\r
+ <td align="left">\r
+ Search the view. Opens a prompt for entering search regex to use.\r
+ </td>\r
+ </tr>\r
+ <tr>\r
+ <td align="left">\r
+ ?\r
+ </td>\r
+ <td align="left">\r
+ Search backwards in the view. Also prompts for regex.\r
+ </td>\r
+ </tr>\r
+ <tr>\r
+ <td align="left">\r
+ n\r
+ </td>\r
+ <td align="left">\r
+ Find next match for the current search regex.\r
+ </td>\r
+ </tr>\r
+ <tr>\r
+ <td align="left">\r
+ N\r
+ </td>\r
+ <td align="left">\r
+ Find previous match for the current search regex.\r
+ </td>\r
+ </tr>\r
+</tbody>\r
+</table>\r
+</div>\r
+<h3><a id="misc-keys"></a>4.6. Misc</h3>\r
<div class="tableblock">\r
<table rules="none"\r
frame="hsides"\r
</tr>\r
<tr>\r
<td align="left">\r
- n\r
+ <em>.</em>\r
</td>\r
<td align="left">\r
Toggle line numbers on/off.\r
<div class="sectionbody">\r
<p>This section describes various ways to specify what revisions to display or\r
otherwise limit the view to. Tig does not itself parse the described\r
-revision options so refer to the relevant git man pages for futher\r
+revision options so refer to the relevant git man pages for further\r
information. Relevant man pages besides git-log(1) are git-diff(1) and\r
git-rev-list(1).</p>\r
<p>You can tune the interaction with git by making use of the options explained\r
<ul>\r
<li>\r
<p>\r
-In it's current state tig is pretty much UTF-8 only.\r
-</p>\r
-</li>\r
-<li>\r
-<p>\r
-If the screen width is very small the main view can draw\r
- outside the current view causing bad wrapping. Same goes\r
- for title and status windows.\r
+Proper locale support: in it's current state tig is pretty much UTF-8 only.\r
</p>\r
</li>\r
<li>\r
<p>\r
-The cursor can wrap-around on the last line and cause the\r
- window to scroll.\r
+Horizontal scrolling.\r
</p>\r
</li>\r
</ul>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 15-Jun-2006 01:28:21 CEST\r
+Last updated 18-Sep-2006 18:23:56 CEST\r
</div>\r
</div>\r
</body>\r
.nf
tig [options]
-tig [options] [\-\-] [git log options]
-tig [options] log [git log options]
-tig [options] diff [git diff options]
-tig [options] show [git show options]
+tig [options] [\-\-] [git options]
+tig [options] log [git options]
+tig [options] diff [git options]
+tig [options] show [git options]
tig [options] < [git command output]
.fi
.fi
.TP
-log [git log options]
+log
Open log view using the given git log options\&.
.TP
-diff [git diff options]
+diff
Open diff view using the given git diff options\&.
.TP
-show [git show options]
+show
Open diff view using the given git show options\&.
.TP
-[git log options]
+[git options]
tig(1) will stop the option parsing when the first command line parameter not starting with "\-" is encountered\&. All options including this one will be passed to git log when loading the main view\&. This makes it possible to say:
.nf
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\&.
+.SS "Tree commands"
+
+.TP
+TIG_TREE_CMD
+The command used for the tree view\&. By default, git\-ls\-tree(1) is used\&. The commands should expect first the commit ID and second a path\&.
+
+.TP
+TIG_BLOB_CMD
+The command used for the blob view\&. By default, git\-cat\-file(1) is used\&. The command gets the blob ID\&.
+
.SH "FILES"
.TP
.TP
\fI\&.git/config\fR
-Repository config file\&. Read on startup with the help of git\-repo\-config(1)\&.
+Repository config file\&. Read on start\-up with the help of git\-repo\-config(1)\&.
.SH "BUGS"
.TP 3
\(bu
-In it's current state tig is pretty much UTF\-8 only\&.
-.TP
-\(bu
-If the screen width is very small the main view can draw outside the current view causing bad wrapping\&. Same goes for title and status windows\&.
+Proper locale support: in it's current state tig is pretty much UTF\-8 only\&.
.TP
\(bu
-The cursor can wrap\-around on the last line and cause the window to scroll\&.
+Horizontal scrolling\&.
.LP
.SH "COPYRIGHT"
<div class="sectionbody">\r
<div class="verseblock">\r
<div class="content">tig [options]\r
-tig [options] [--] [git log options]\r
-tig [options] log [git log options]\r
-tig [options] diff [git diff options]\r
-tig [options] show [git show options]\r
+tig [options] [--] [git options]\r
+tig [options] log [git options]\r
+tig [options] diff [git options]\r
+tig [options] show [git options]\r
tig [options] < [git command output]</div></div>\r
</div>\r
<h2>DESCRIPTION</h2>\r
</div></div>\r
</dd>\r
<dt>\r
-log [git log options]\r
+log\r
</dt>\r
<dd>\r
<p>\r
</p>\r
</dd>\r
<dt>\r
-diff [git diff options]\r
+diff\r
</dt>\r
<dd>\r
<p>\r
</p>\r
</dd>\r
<dt>\r
-show [git show options]\r
+show\r
</dt>\r
<dd>\r
<p>\r
</p>\r
</dd>\r
<dt>\r
-[git log options]\r
+[git options]\r
</dt>\r
<dd>\r
<p>\r
</p>\r
</dd>\r
</dl>\r
+<h3>Tree commands</h3>\r
+<dl>\r
+<dt>\r
+TIG_TREE_CMD\r
+</dt>\r
+<dd>\r
+<p>\r
+ The command used for the tree view. By default, git-ls-tree(1) is\r
+ used. The commands should expect first the commit ID and second\r
+ a path.\r
+</p>\r
+</dd>\r
+<dt>\r
+TIG_BLOB_CMD\r
+</dt>\r
+<dd>\r
+<p>\r
+ The command used for the blob view. By default, git-cat-file(1) is\r
+ used. The command gets the blob ID.\r
+</p>\r
+</dd>\r
+</dl>\r
</div>\r
<h2>FILES</h2>\r
<div class="sectionbody">\r
</dt>\r
<dd>\r
<p>\r
- Repository config file. Read on startup with the help of\r
+ Repository config file. Read on start-up with the help of\r
git-repo-config(1).\r
</p>\r
</dd>\r
<ul>\r
<li>\r
<p>\r
-In it's current state tig is pretty much UTF-8 only.\r
-</p>\r
-</li>\r
-<li>\r
-<p>\r
-If the screen width is very small the main view can draw\r
- outside the current view causing bad wrapping. Same goes\r
- for title and status windows.\r
+Proper locale support: in it's current state tig is pretty much UTF-8 only.\r
</p>\r
</li>\r
<li>\r
<p>\r
-The cursor can wrap-around on the last line and cause the\r
- window to scroll.\r
+Horizontal scrolling.\r
</p>\r
</li>\r
</ul>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 15-Jun-2006 01:28:15 CEST\r
+Last updated 18-Sep-2006 18:23:50 CEST\r
</div>\r
</div>\r
</body>\r
.TP
\fIshow\-rev\-graph\fR (bool)
-Show revision graph in the main view on startup\&. Can be toggled with \fIg\fR\&.
+Show revision graph in the main view on start\-up\&. Can be toggled with \fIg\fR\&.
.TP
\fIline\-number\-interval\fR (int)
bind diff a previous
bind diff d next
bind diff b move\-first\-line
+ # 'unbind' the default quit key binding
+ bind main Q none
.fi
-Keys are mapped by first searching the keybindings for the current view, then the keybindings for the \fIgeneric\fR keymap, and last the default keybindings\&. Thus, the view keybindings shaddow the generic keybindings which shaddow the built\-in keybindings\&.
+Keys are mapped by first searching the keybindings for the current view, then the keybindings for the \fIgeneric\fR keymap, and last the default keybindings\&. Thus, the view keybindings shadow the generic keybindings which Shadow the built\-in keybindings\&.
.TP
Keymaps
view\-main Show main view
view\-diff Show diff view
view\-log Show log view
-view\-help Show help page
+view\-tree Show tree view
+view\-blob Show blob view
view\-pager Show pager view
+view\-help Show help page
.fi
.nf
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
+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
.fi
Scrolling:
.nf
-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\-line\-up Scroll one line up
+scroll\-line\-down Scroll one line down
+scroll\-page\-eup Scroll one page up
+scroll\-page\-down Scroll one page down
.fi
Misc:
.nf
+none Do nothing
prompt Bring up the prompt
-screen\-update Update the screen
screen\-redraw Redraw the screen
screen\-resize Resize the screen
show\-version Show version information
stop\-loading Stop all loading views
toggle\-lineno Toggle line numbers
-toggle\-rev_graph Toggle revision graph visualization
+toggle\-rev\-graph Toggle revision graph visualization
.fi
.SH "COLOR COMMAND"
-Color commands control highlighting and the user interface styles\&. If your terminal supports color, these commands can be used to assign foreground and backgound combinations to certain areas\&. Optionally, an attribute can be given as the last parameter\&. The syntax is:
+Color commands control highlighting and the user interface styles\&. If your terminal supports color, these commands can be used to assign foreground and background combinations to certain areas\&. Optionally, an attribute can be given as the last parameter\&. The syntax is:
.nf
\fIcolor\fR \fIarea\fR \fIfgcolor\fR \fIbgcolor\fR \fI[attributes]\fR
.TP
Title window colors
-Appearence of the title windows when they are attached to any backgrounded windows and the current window\&.
+Appearance of the title windows when they are attached to any backgrounded windows and the current window\&.
\fItitle\-blur\fR, \fItitle\-focus\fR
.TP
Pretty print commit headers
-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 comitter date\&.
+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\&.
\fIpp\-author\fR, \fIpp\-commit\fR, \fIpp\-merge\fR, \fIpp\-date\fR, \fIpp\-adate\fR, \fIpp\-cdate\fR
.TP
Commit message
-For now only Signed\-off\-by lines are colorized\&.
+For now only Signed\-off\-by and Acked\-by lines are colorized\&.
-\fIsignoff\fR
+\fIsignoff\fR, \fIacked\fR
.SH "COPYRIGHT"
</dt>\r
<dd>\r
<p>\r
- Show revision graph in the main view on startup. Can be toggled with\r
+ Show revision graph in the main view on start-up. Can be toggled with\r
<em>g</em>.\r
</p>\r
</dd>\r
bind main space enter\r
bind diff a previous\r
bind diff d next\r
- bind diff b move-first-line</tt></pre>\r
+ bind diff b move-first-line\r
+ # 'unbind' the default quit key binding\r
+ bind main Q none</tt></pre>\r
</div></div>\r
<p>Keys are mapped by first searching the keybindings for the current view, then\r
the keybindings for the <strong>generic</strong> keymap, and last the default keybindings.\r
-Thus, the view keybindings shaddow the generic keybindings which shaddow the\r
+Thus, the view keybindings shadow the generic keybindings which Shadow the\r
built-in keybindings.</p>\r
<dl>\r
<dt>\r
</tr>\r
<tr>\r
<td align="left">\r
- view-help\r
+ view-tree\r
</td>\r
<td align="left">\r
- Show help page\r
+ Show tree view\r
+ </td>\r
+ </tr>\r
+ <tr>\r
+ <td align="left">\r
+ view-blob\r
+ </td>\r
+ <td align="left">\r
+ Show blob view\r
</td>\r
</tr>\r
<tr>\r
Show pager view\r
</td>\r
</tr>\r
+ <tr>\r
+ <td align="left">\r
+ view-help\r
+ </td>\r
+ <td align="left">\r
+ Show help page\r
+ </td>\r
+ </tr>\r
</tbody>\r
</table>\r
</div>\r
</tr>\r
<tr>\r
<td align="left">\r
- move-page_down\r
+ move-page-down\r
</td>\r
<td align="left">\r
Move cursor one page down\r
</tr>\r
<tr>\r
<td align="left">\r
- move-page_up\r
+ move-page-up\r
</td>\r
<td align="left">\r
Move cursor one page up\r
</tr>\r
<tr>\r
<td align="left">\r
- move-first_line\r
+ move-first-line\r
</td>\r
<td align="left">\r
Move cursor to first line\r
</tr>\r
<tr>\r
<td align="left">\r
- move-last_line\r
+ move-last-line\r
</td>\r
<td align="left">\r
Move cursor to last line\r
<tbody valign="top">\r
<tr>\r
<td align="left">\r
- scroll-line_up\r
+ scroll-line-up\r
</td>\r
<td align="left">\r
Scroll one line up\r
</tr>\r
<tr>\r
<td align="left">\r
- scroll-line_down\r
+ scroll-line-down\r
</td>\r
<td align="left">\r
Scroll one line down\r
</tr>\r
<tr>\r
<td align="left">\r
- scroll-page_up\r
+ scroll-page-eup\r
</td>\r
<td align="left">\r
Scroll one page up\r
</tr>\r
<tr>\r
<td align="left">\r
- scroll-page_down\r
+ scroll-page-down\r
</td>\r
<td align="left">\r
Scroll one page down\r
<tbody valign="top">\r
<tr>\r
<td align="left">\r
- prompt\r
+ none\r
</td>\r
<td align="left">\r
- Bring up the prompt\r
+ Do nothing\r
</td>\r
</tr>\r
<tr>\r
<td align="left">\r
- screen-update\r
+ prompt\r
</td>\r
<td align="left">\r
- Update the screen\r
+ Bring up the prompt\r
</td>\r
</tr>\r
<tr>\r
</tr>\r
<tr>\r
<td align="left">\r
- toggle-rev_graph\r
+ toggle-rev-graph\r
</td>\r
<td align="left">\r
Toggle revision graph visualization\r
<div class="sectionbody">\r
<p>Color commands control highlighting and the user interface styles. If your\r
terminal supports color, these commands can be used to assign foreground and\r
-backgound combinations to certain areas. Optionally, an attribute can be given\r
+background combinations to certain areas. Optionally, an attribute can be given\r
as the last parameter. The syntax is:</p>\r
<div class="verseblock">\r
<div class="content"> <strong>color</strong> <em>area</em> <em>fgcolor</em> <em>bgcolor</em> <em>[attributes]</em></div></div>\r
</dt>\r
<dd>\r
<p>\r
-Appearence of the title windows when they are attached\r
+Appearance of the title windows when they are attached\r
to any backgrounded windows and the current window.\r
</p>\r
<p><strong>title-blur</strong>, <strong>title-focus</strong></p>\r
<p>\r
Commit diffs and the revision logs are usually formatted using pretty printed\r
headers , unless <tt>--pretty=raw</tt> was given. This includes lines, such as merge\r
-info, commit ID, and author and comitter date.\r
+info, commit ID, and author and committer date.\r
</p>\r
<p><strong>pp-author</strong>, <strong>pp-commit</strong>, <strong>pp-merge</strong>, <strong>pp-date</strong>, <strong>pp-adate</strong>, <strong>pp-cdate</strong></p>\r
</dd>\r
</dt>\r
<dd>\r
<p>\r
-For now only <tt>Signed-off-by</tt> lines are colorized.\r
+For now only <tt>Signed-off-by</tt> and <tt>Acked-by</tt> lines are colorized.\r
</p>\r
-<p><strong>signoff</strong></p>\r
+<p><strong>signoff</strong>, <strong>acked</strong></p>\r
</dd>\r
</dl>\r
</div>\r
</div>\r
<div id="footer">\r
<div id="footer-text">\r
-Last updated 03-Sep-2006 22:04:39 CEST\r
+Last updated 18-Sep-2006 18:23:53 CEST\r
</div>\r
</div>\r
</body>\r