]>
Commit | Line | Data |
---|---|---|
7fc9d69f JH |
1 | gitk(1) |
2 | ======= | |
3 | ||
4 | NAME | |
5 | ---- | |
c3f0baac | 6 | gitk - The git repository browser |
7fc9d69f JH |
7 | |
8 | SYNOPSIS | |
9 | -------- | |
5164b6cd | 10 | 'gitk' [<option>...] [<revs>] [--] [<path>...] |
7fc9d69f JH |
11 | |
12 | DESCRIPTION | |
13 | ----------- | |
5164b6cd JF |
14 | Displays changes in a repository or a selected set of commits. This includes |
15 | visualizing the commit graph, showing information related to each commit, and | |
16 | the files in the trees of each revision. | |
7fc9d69f | 17 | |
5164b6cd JF |
18 | Historically, gitk was the first repository browser. It's written in tcl/tk |
19 | and started off in a separate repository but was later merged into the main | |
20 | git repository. | |
7fc9d69f JH |
21 | |
22 | OPTIONS | |
23 | ------- | |
5164b6cd | 24 | To control which revisions to shown, the command takes options applicable to |
5162e697 | 25 | the linkgit:git-rev-list[1] command. This manual page describes only the most |
5164b6cd JF |
26 | frequently used options. |
27 | ||
3240240f SB |
28 | -n <number>:: |
29 | --max-count=<number>:: | |
5164b6cd JF |
30 | |
31 | Limits the number of commits to show. | |
32 | ||
33 | --since=<date>:: | |
34 | ||
35 | Show commits more recent than a specific date. | |
36 | ||
37 | --until=<date>:: | |
38 | ||
39 | Show commits older than a specific date. | |
7fc9d69f | 40 | |
44d2775a JF |
41 | --all:: |
42 | ||
43 | Show all branches. | |
44 | ||
9f1915d3 RQ |
45 | --merge:: |
46 | ||
47 | After an attempt to merge stops with conflicts, show the commits on | |
48 | the history between two branches (i.e. the HEAD and the MERGE_HEAD) | |
49 | that modify the conflicted files. | |
50 | ||
5164b6cd | 51 | <revs>:: |
7fc9d69f | 52 | |
5164b6cd JF |
53 | Limit the revisions to show. This can be either a single revision |
54 | meaning show from the given revision and back, or it can be a range in | |
55 | the form "'<from>'..'<to>'" to show all revisions between '<from>' and | |
56 | back to '<to>'. Note, more advanced revision selection can be applied. | |
41a5564e | 57 | For a more complete list of ways to spell object names, see |
5162e697 | 58 | "SPECIFYING REVISIONS" section in linkgit:git-rev-parse[1]. |
5164b6cd JF |
59 | |
60 | <path>:: | |
61 | ||
62 | Limit commits to the ones touching files in the given paths. Note, to | |
63 | avoid ambiguity wrt. revision names use "--" to separate the paths | |
3dff5379 | 64 | from any preceding options. |
7fc9d69f | 65 | |
bd663611 LT |
66 | Examples |
67 | -------- | |
68 | gitk v2.6.12.. include/scsi drivers/scsi:: | |
69 | ||
70 | Show as the changes since version 'v2.6.12' that changed any | |
71 | file in the include/scsi or drivers/scsi subdirectories | |
72 | ||
e994004f | 73 | gitk --since="2 weeks ago" \-- gitk:: |
bd663611 LT |
74 | |
75 | Show the changes during the last two weeks to the file 'gitk'. | |
76 | The "--" is necessary to avoid confusion with the *branch* named | |
77 | 'gitk' | |
78 | ||
1d5bf7fc | 79 | gitk --max-count=100 --all \-- Makefile:: |
44d2775a JF |
80 | |
81 | Show at most 100 changes made to the file 'Makefile'. Instead of only | |
82 | looking for changes in the current branch look in all branches. | |
83 | ||
e8095078 CC |
84 | Files |
85 | ----- | |
86 | Gitk creates the .gitk file in your $HOME directory to store preferences | |
87 | such as display options, font, and colors. | |
88 | ||
56ae8df5 | 89 | SEE ALSO |
5164b6cd JF |
90 | -------- |
91 | 'qgit(1)':: | |
92 | A repository browser written in C++ using Qt. | |
93 | ||
94 | 'gitview(1)':: | |
95 | A repository browser written in Python using Gtk. It's based on | |
96 | 'bzrk(1)' and distributed in the contrib area of the git repository. | |
97 | ||
98 | 'tig(1)':: | |
99 | A minimal repository browser and git tool output highlighter written | |
100 | in C using Ncurses. | |
101 | ||
7fc9d69f JH |
102 | Author |
103 | ------ | |
5164b6cd | 104 | Written by Paul Mackerras <paulus@samba.org>. |
7fc9d69f JH |
105 | |
106 | Documentation | |
107 | -------------- | |
5164b6cd JF |
108 | Documentation by Junio C Hamano, Jonas Fonseca, and the git-list |
109 | <git@vger.kernel.org>. | |
7fc9d69f JH |
110 | |
111 | GIT | |
112 | --- | |
9e1f0a85 | 113 | Part of the linkgit:git[1] suite |