]>
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 JF |
24 | To control which revisions to shown, the command takes options applicable to |
25 | the gitlink:git-rev-list[1] command. This manual page describes only the most | |
26 | frequently used options. | |
27 | ||
28 | -n <number>, --max-count=<number>:: | |
29 | ||
30 | Limits the number of commits to show. | |
31 | ||
32 | --since=<date>:: | |
33 | ||
34 | Show commits more recent than a specific date. | |
35 | ||
36 | --until=<date>:: | |
37 | ||
38 | Show commits older than a specific date. | |
7fc9d69f | 39 | |
44d2775a JF |
40 | --all:: |
41 | ||
42 | Show all branches. | |
43 | ||
5164b6cd | 44 | <revs>:: |
7fc9d69f | 45 | |
5164b6cd JF |
46 | Limit the revisions to show. This can be either a single revision |
47 | meaning show from the given revision and back, or it can be a range in | |
48 | the form "'<from>'..'<to>'" to show all revisions between '<from>' and | |
49 | back to '<to>'. Note, more advanced revision selection can be applied. | |
41a5564e SP |
50 | For a more complete list of ways to spell object names, see |
51 | "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1]. | |
5164b6cd JF |
52 | |
53 | <path>:: | |
54 | ||
55 | Limit commits to the ones touching files in the given paths. Note, to | |
56 | avoid ambiguity wrt. revision names use "--" to separate the paths | |
3dff5379 | 57 | from any preceding options. |
7fc9d69f | 58 | |
bd663611 LT |
59 | Examples |
60 | -------- | |
61 | gitk v2.6.12.. include/scsi drivers/scsi:: | |
62 | ||
63 | Show as the changes since version 'v2.6.12' that changed any | |
64 | file in the include/scsi or drivers/scsi subdirectories | |
65 | ||
e994004f | 66 | gitk --since="2 weeks ago" \-- gitk:: |
bd663611 LT |
67 | |
68 | Show the changes during the last two weeks to the file 'gitk'. | |
69 | The "--" is necessary to avoid confusion with the *branch* named | |
70 | 'gitk' | |
71 | ||
1d5bf7fc | 72 | gitk --max-count=100 --all \-- Makefile:: |
44d2775a JF |
73 | |
74 | Show at most 100 changes made to the file 'Makefile'. Instead of only | |
75 | looking for changes in the current branch look in all branches. | |
76 | ||
5164b6cd JF |
77 | See Also |
78 | -------- | |
79 | 'qgit(1)':: | |
80 | A repository browser written in C++ using Qt. | |
81 | ||
82 | 'gitview(1)':: | |
83 | A repository browser written in Python using Gtk. It's based on | |
84 | 'bzrk(1)' and distributed in the contrib area of the git repository. | |
85 | ||
86 | 'tig(1)':: | |
87 | A minimal repository browser and git tool output highlighter written | |
88 | in C using Ncurses. | |
89 | ||
7fc9d69f JH |
90 | Author |
91 | ------ | |
5164b6cd | 92 | Written by Paul Mackerras <paulus@samba.org>. |
7fc9d69f JH |
93 | |
94 | Documentation | |
95 | -------------- | |
5164b6cd JF |
96 | Documentation by Junio C Hamano, Jonas Fonseca, and the git-list |
97 | <git@vger.kernel.org>. | |
7fc9d69f JH |
98 | |
99 | GIT | |
100 | --- | |
a7154e91 | 101 | Part of the gitlink:git[7] suite |