summaryrefslogtreecommitdiffstats
path: root/gitk.html
diff options
context:
space:
mode:
authorJunio C Hamano <junio@hera.kernel.org>2006-08-26 08:43:31 +0000
committerJunio C Hamano <junio@hera.kernel.org>2006-08-26 08:43:31 +0000
commit6b2cee12edbdbc714335b12e6cfe34cd4933799f (patch)
tree8a053e17c1915a48817205ed27bbdfd475ced116 /gitk.html
parent8a0a21e3f8e9d75a455aa4170153405d7f1d74be (diff)
downloadgit-htmldocs-6b2cee12edbdbc714335b12e6cfe34cd4933799f.tar.gz
Autogenerated HTML docs for v1.4.2-ga7f0
Diffstat (limited to 'gitk.html')
-rw-r--r--gitk.html89
1 files changed, 79 insertions, 10 deletions
diff --git a/gitk.html b/gitk.html
index 2c90c36f8..9d79ee949 100644
--- a/gitk.html
+++ b/gitk.html
@@ -266,35 +266,72 @@ gitk(1) Manual Page
<h2>NAME</h2>
<div class="sectionbody">
<p>gitk -
- Some git command not yet documented.
+ git repository browser
</p>
</div>
</div>
<h2>SYNOPSIS</h2>
<div class="sectionbody">
-<p><em>gitk</em> [ --option ] &lt;args&gt;&#8230;</p>
+<p><em>gitk</em> [&lt;option&gt;&#8230;] [&lt;revs&gt;] [--] [&lt;path&gt;&#8230;]</p>
</div>
<h2>DESCRIPTION</h2>
<div class="sectionbody">
-<p>Does something not yet documented.</p>
+<p>Displays changes in a repository or a selected set of commits. This includes
+visualizing the commit graph, showing information related to each commit, and
+the files in the trees of each revision.</p>
+<p>Historically, gitk was the first repository browser. It's written in tcl/tk
+and started off in a separate repository but was later merged into the main
+git repository.</p>
</div>
<h2>OPTIONS</h2>
<div class="sectionbody">
+<p>To control which revisions to shown, the command takes options applicable to
+the <a href="git-rev-list.html">git-rev-list(1)</a> command. This manual page describes only the most
+frequently used options.</p>
<dl>
<dt>
---option
+-n &lt;number&gt;, --max-count=&lt;number&gt;
</dt>
<dd>
<p>
- Some option not yet documented.
+ Limits the number of commits to show.
</p>
</dd>
<dt>
-&lt;args&gt;&#8230;
+--since=&lt;date&gt;
</dt>
<dd>
<p>
- Some argument not yet documented.
+ Show commits more recent than a specific date.
+</p>
+</dd>
+<dt>
+--until=&lt;date&gt;
+</dt>
+<dd>
+<p>
+ Show commits older than a specific date.
+</p>
+</dd>
+<dt>
+&lt;revs&gt;
+</dt>
+<dd>
+<p>
+ Limit the revisions to show. This can be either a single revision
+ meaning show from the given revision and back, or it can be a range in
+ the form "<em>&lt;from&gt;</em>..<em>&lt;to&gt;</em>" to show all revisions between <em>&lt;from&gt;</em> and
+ back to <em>&lt;to&gt;</em>. Note, more advanced revision selection can be applied.
+</p>
+</dd>
+<dt>
+&lt;path&gt;
+</dt>
+<dd>
+<p>
+ Limit commits to the ones touching files in the given paths. Note, to
+ avoid ambiguity wrt. revision names use "--" to separate the paths
+ from any preceeding options.
</p>
</dd>
</dl>
@@ -323,13 +360,45 @@ gitk --since="2 weeks ago" -- gitk
</dd>
</dl>
</div>
+<h2>See Also</h2>
+<div class="sectionbody">
+<dl>
+<dt>
+<em>qgit(1)</em>
+</dt>
+<dd>
+<p>
+ A repository browser written in C++ using Qt.
+</p>
+</dd>
+<dt>
+<em>gitview(1)</em>
+</dt>
+<dd>
+<p>
+ A repository browser written in Python using Gtk. It's based on
+ <em>bzrk(1)</em> and distributed in the contrib area of the git repository.
+</p>
+</dd>
+<dt>
+<em>tig(1)</em>
+</dt>
+<dd>
+<p>
+ A minimal repository browser and git tool output highlighter written
+ in C using Ncurses.
+</p>
+</dd>
+</dl>
+</div>
<h2>Author</h2>
<div class="sectionbody">
-<p>Written by Paul Mackerras &lt;paulus@samba.org&gt;</p>
+<p>Written by Paul Mackerras &lt;paulus@samba.org&gt;.</p>
</div>
<h2>Documentation</h2>
<div class="sectionbody">
-<p>Documentation by Junio C Hamano and the git-list &lt;git@vger.kernel.org&gt;.</p>
+<p>Documentation by Junio C Hamano, Jonas Fonseca, and the git-list
+&lt;git@vger.kernel.org&gt;.</p>
</div>
<h2>GIT</h2>
<div class="sectionbody">
@@ -337,7 +406,7 @@ gitk --since="2 weeks ago" -- gitk
</div>
<div id="footer">
<div id="footer-text">
-Last updated 15-Jul-2006 01:38:23 UTC
+Last updated 26-Aug-2006 08:43:08 UTC
</div>
</div>
</body>