doc/source/en/TortoiseGit/git_doc/gitk.html.xml

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">\r
   3 \r
   4 <article lang="en" id="gitk(1)">\r
   5 <articleinfo>\r
   6     <title>gitk(1)</title>\r
   7         <indexterm>\r
   8                 <primary>gitk(1)</primary>\r
   9         </indexterm>\r
  10 </articleinfo>\r
  11 <simplesect id="_name">\r
  12 <title>NAME</title>\r
  13 <simpara>gitk - The git repository browser</simpara>\r
  14 </simplesect>\r
  15 <simplesect id="_synopsis">\r
  16 <title>SYNOPSIS</title>\r
  17 <simpara><emphasis>gitk</emphasis> [&lt;option&gt;&#8230;] [&lt;revs&gt;] [--] [&lt;path&gt;&#8230;]</simpara>\r
  18 </simplesect>\r
  19 <simplesect id="_description">\r
  20 <title>DESCRIPTION</title>\r
  21 <simpara>Displays changes in a repository or a selected set of commits. This includes\r
  22 visualizing the commit graph, showing information related to each commit, and\r
  23 the files in the trees of each revision.</simpara>\r
  24 <simpara>Historically, gitk was the first repository browser. It&#8217;s written in tcl/tk\r
  25 and started off in a separate repository but was later merged into the main\r
  26 git repository.</simpara>\r
  27 </simplesect>\r
  28 <simplesect id="_options">\r
  29 <title>OPTIONS</title>\r
  30 <simpara>To control which revisions to show, the command takes options applicable to\r
  31 the <emphasis>git-rev-list</emphasis> command (see <xref linkend="git-rev-list(1)"/>).\r
  32 This manual page describes only the most\r
  33 frequently used options.</simpara>\r
  34 <variablelist>\r
  35 <varlistentry>\r
  36 <term>\r
  37 -n &lt;number&gt;\r
  38 </term>\r
  39 <term>\r
  40 --max-count=&lt;number&gt;\r
  41 </term>\r
  42 <listitem>\r
  43 <simpara>\r
  44         Limits the number of commits to show.\r
  45 </simpara>\r
  46 </listitem>\r
  47 </varlistentry>\r
  48 <varlistentry>\r
  49 <term>\r
  50 --since=&lt;date&gt;\r
  51 </term>\r
  52 <listitem>\r
  53 <simpara>\r
  54         Show commits more recent than a specific date.\r
  55 </simpara>\r
  56 </listitem>\r
  57 </varlistentry>\r
  58 <varlistentry>\r
  59 <term>\r
  60 --until=&lt;date&gt;\r
  61 </term>\r
  62 <listitem>\r
  63 <simpara>\r
  64         Show commits older than a specific date.\r
  65 </simpara>\r
  66 </listitem>\r
  67 </varlistentry>\r
  68 <varlistentry>\r
  69 <term>\r
  70 --all\r
  71 </term>\r
  72 <listitem>\r
  73 <simpara>\r
  74         Show all branches.\r
  75 </simpara>\r
  76 </listitem>\r
  77 </varlistentry>\r
  78 <varlistentry>\r
  79 <term>\r
  80 --merge\r
  81 </term>\r
  82 <listitem>\r
  83 <simpara>\r
  84         After an attempt to merge stops with conflicts, show the commits on\r
  85         the history between two branches (i.e. the HEAD and the MERGE_HEAD)\r
  86         that modify the conflicted files.\r
  87 </simpara>\r
  88 </listitem>\r
  89 </varlistentry>\r
  90 <varlistentry>\r
  91 <term>\r
  92 --argscmd=&lt;command&gt;\r
  93 </term>\r
  94 <listitem>\r
  95 <simpara>\r
  96         Command to be run each time gitk has to determine the list of\r
  97         &lt;revs&gt; to show.  The command is expected to print on its standard\r
  98         output a list of additional revs to be shown, one per line.\r
  99         Use this instead of explicitly specifying &lt;revs&gt; if the set of\r
 100         commits to show may vary between refreshes.\r
 101 </simpara>\r
 102 </listitem>\r
 103 </varlistentry>\r
 104 <varlistentry>\r
 105 <term>\r
 106 --select-commit=&lt;ref&gt;\r
 107 </term>\r
 108 <listitem>\r
 109 <simpara>\r
 110         Automatically select the specified commit after loading the graph.\r
 111         Default behavior is equivalent to specifying <emphasis>--select-commit=HEAD</emphasis>.\r
 112 </simpara>\r
 113 </listitem>\r
 114 </varlistentry>\r
 115 <varlistentry>\r
 116 <term>\r
 117 &lt;revs&gt;\r
 118 </term>\r
 119 <listitem>\r
 120 <simpara>\r
 121         Limit the revisions to show. This can be either a single revision\r
 122         meaning show from the given revision and back, or it can be a range in\r
 123         the form "<emphasis>&lt;from&gt;</emphasis>..<emphasis>&lt;to&gt;</emphasis>" to show all revisions between <emphasis>&lt;from&gt;</emphasis> and\r
 124         back to <emphasis>&lt;to&gt;</emphasis>. Note, more advanced revision selection can be applied.\r
 125         For a more complete list of ways to spell object names, see\r
 126         "SPECIFYING REVISIONS" section in <xref linkend="git-rev-parse(1)"/>.\r
 127 </simpara>\r
 128 </listitem>\r
 129 </varlistentry>\r
 130 <varlistentry>\r
 131 <term>\r
 132 &lt;path&gt;&#8230;\r
 133 </term>\r
 134 <listitem>\r
 135 <simpara>\r
 136         Limit commits to the ones touching files in the given paths. Note, to\r
 137         avoid ambiguity wrt. revision names use "--" to separate the paths\r
 138         from any preceding options.\r
 139 </simpara>\r
 140 </listitem>\r
 141 </varlistentry>\r
 142 </variablelist>\r
 143 </simplesect>\r
 144 <simplesect id="_examples">\r
 145 <title>Examples</title>\r
 146 <variablelist>\r
 147 <varlistentry>\r
 148 <term>\r
 149 gitk v2.6.12.. include/scsi drivers/scsi\r
 150 </term>\r
 151 <listitem>\r
 152 <simpara>\r
 153         Show the changes since version <emphasis>v2.6.12</emphasis> that changed any\r
 154         file in the include/scsi or drivers/scsi subdirectories\r
 155 </simpara>\r
 156 </listitem>\r
 157 </varlistentry>\r
 158 <varlistentry>\r
 159 <term>\r
 160 gitk --since="2 weeks ago" -- gitk\r
 161 </term>\r
 162 <listitem>\r
 163 <simpara>\r
 164         Show the changes during the last two weeks to the file <emphasis>gitk</emphasis>.\r
 165         The "--" is necessary to avoid confusion with the <emphasis role="strong">branch</emphasis> named\r
 166         <emphasis>gitk</emphasis>\r
 167 </simpara>\r
 168 </listitem>\r
 169 </varlistentry>\r
 170 <varlistentry>\r
 171 <term>\r
 172 gitk --max-count=100 --all -- Makefile\r
 173 </term>\r
 174 <listitem>\r
 175 <simpara>\r
 176         Show at most 100 changes made to the file <emphasis>Makefile</emphasis>. Instead of only\r
 177         looking for changes in the current branch look in all branches.\r
 178 </simpara>\r
 179 </listitem>\r
 180 </varlistentry>\r
 181 </variablelist>\r
 182 </simplesect>\r
 183 <simplesect id="_files">\r
 184 <title>Files</title>\r
 185 <simpara>Gitk creates the .gitk file in your $HOME directory to store preferences\r
 186 such as display options, font, and colors.</simpara>\r
 187 </simplesect>\r
 188 <simplesect id="_see_also">\r
 189 <title>SEE ALSO</title>\r
 190 <variablelist>\r
 191 <varlistentry>\r
 192 <term>\r
 193 <emphasis>qgit(1)</emphasis>\r
 194 </term>\r
 195 <listitem>\r
 196 <simpara>\r
 197         A repository browser written in C++ using Qt.\r
 198 </simpara>\r
 199 </listitem>\r
 200 </varlistentry>\r
 201 <varlistentry>\r
 202 <term>\r
 203 <emphasis>gitview(1)</emphasis>\r
 204 </term>\r
 205 <listitem>\r
 206 <simpara>\r
 207         A repository browser written in Python using Gtk. It&#8217;s based on\r
 208         <emphasis>bzrk(1)</emphasis> and distributed in the contrib area of the git repository.\r
 209 </simpara>\r
 210 </listitem>\r
 211 </varlistentry>\r
 212 <varlistentry>\r
 213 <term>\r
 214 <emphasis>tig(1)</emphasis>\r
 215 </term>\r
 216 <listitem>\r
 217 <simpara>\r
 218         A minimal repository browser and git tool output highlighter written\r
 219         in C using Ncurses.\r
 220 </simpara>\r
 221 </listitem>\r
 222 </varlistentry>\r
 223 </variablelist>\r
 224 </simplesect>\r
 225 <simplesect id="_author">\r
 226 <title>Author</title>\r
 227 <simpara>Written by Paul Mackerras &lt;<ulink url="mailto:paulus@samba.org">paulus@samba.org</ulink>&gt;.</simpara>\r
 228 </simplesect>\r
 229 <simplesect id="_documentation">\r
 230 <title>Documentation</title>\r
 231 <simpara>Documentation by Junio C Hamano, Jonas Fonseca, and the git-list\r
 232 &lt;<ulink url="mailto:git@vger.kernel.org">git@vger.kernel.org</ulink>&gt;.</simpara>\r
 233 </simplesect>\r
 234 <simplesect id="_git">\r
 235 <title>GIT</title>\r
 236 <simpara>Part of the <xref linkend="git(1)"/> suite</simpara>\r
 237 </simplesect>\r
 238 </article>\r