Sync docs
[tig] / manual.html
index 0bf8c90..43a2b14 100644 (file)
@@ -306,6 +306,11 @@ commit with the log message, diffstat, and the diff.</p>
 <a href="#history-commands">History Commands</a>\r
 </p>\r
 </li>\r
+<li>\r
+<p>\r
+<a href="#tree-commands">Tree Commands</a>\r
+</p>\r
+</li>\r
 </ul>\r
 </li>\r
 <li>\r
@@ -355,6 +360,11 @@ commit with the log message, diffstat, and the diff.</p>
 <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
@@ -513,6 +523,28 @@ TIG_MAIN_CMD
 </p>\r
 </dd>\r
 </dl>\r
+<h3><a id="tree-commands"></a>2.3. 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. Takes two arguments, the first\r
+        is the revision ID and the second is the path of the directory tree,\r
+        empty for the root directory. Defaults to "git ls-tree %s %s".\r
+</p>\r
+</dd>\r
+<dt>\r
+TIG_BLOB_CMD\r
+</dt>\r
+<dd>\r
+<p>\r
+        The command used for the blob view. Takes one argument which is\r
+        the blob ID. Defaults to "git cat-file blob %s".\r
+</p>\r
+</dd>\r
+</dl>\r
 </div>\r
 <h2><a id="viewer"></a>3. The Viewer</h2>\r
 <div class="sectionbody">\r
@@ -530,7 +562,7 @@ and the diff view in the bottom window. You can switch between the two views
 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
@@ -570,6 +602,25 @@ The diff view
 </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
@@ -657,7 +708,23 @@ cellspacing="0" cellpadding="4">
   </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
@@ -713,7 +780,7 @@ cellspacing="0" cellpadding="4">
     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
@@ -849,7 +916,60 @@ cellspacing="0" cellpadding="4">
 </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
@@ -901,7 +1021,7 @@ cellspacing="0" cellpadding="4">
   </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
@@ -931,7 +1051,7 @@ cellspacing="0" cellpadding="4">
 <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
@@ -1034,20 +1154,12 @@ accomplished using:</p>
 <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
@@ -1079,27 +1191,28 @@ the Free Software Foundation; either version 2 of the License, or
 <ul>\r
 <li>\r
 <p>\r
-Homepage: <a href="http://jonas.nitro.dk/tig">http://jonas.nitro.dk/tig</a>\r
+Homepage:    <a href="http://jonas.nitro.dk/tig">http://jonas.nitro.dk/tig</a>\r
 </p>\r
 </li>\r
 <li>\r
 <p>\r
-Manual: <a href="http://jonas.nitro.dk/tig/manual.html">http://jonas.nitro.dk/tig/manual.html</a>\r
+Manual:      <a href="http://jonas.nitro.dk/tig/manual.html">http://jonas.nitro.dk/tig/manual.html</a>\r
 </p>\r
 </li>\r
 <li>\r
 <p>\r
-Releases: <a href="http://jonas.nitro.dk/tig/releases">http://jonas.nitro.dk/tig/releases</a>\r
+Releases:    <a href="http://jonas.nitro.dk/tig/releases">http://jonas.nitro.dk/tig/releases</a>\r
 </p>\r
 </li>\r
 <li>\r
 <p>\r
-Git URL:  <a href="http://jonas.nitro.dk/tig/tig.git">http://jonas.nitro.dk/tig/tig.git</a>\r
+Git URL:     <a href="http://jonas.nitro.dk/tig/tig.git">http://jonas.nitro.dk/tig/tig.git</a> or\r
+                git://repo.or.cz/tig.git\r
 </p>\r
 </li>\r
 <li>\r
 <p>\r
-Gitweb: <a href="http://pasky.or.cz/gitweb.cgi?p=tig.git;a=summary">http://pasky.or.cz/gitweb.cgi?p=tig.git;a=summary</a>\r
+Gitweb:      <a href="http://repo.or.cz/?p=tig.git;a=summary">http://repo.or.cz/?p=tig.git;a=summary</a>\r
 </p>\r
 </li>\r
 </ul>\r
@@ -1137,7 +1250,7 @@ gitview(1)
 </div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 15-Jun-2006 01:28:21 CEST\r
+Last updated 25-Sep-2006 01:14:32 CEST\r
 </div>\r
 </div>\r
 </body>\r