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