OSDN Git Service

Add Git official document to help
[tortoisegit/TortoiseGitJp.git] / 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