]>
Commit | Line | Data |
---|---|---|
7fc9d69f JH |
1 | gitk(1) |
2 | ======= | |
3 | ||
4 | NAME | |
5 | ---- | |
2de9b711 | 6 | gitk - The Git repository browser |
7fc9d69f JH |
7 | |
8 | SYNOPSIS | |
9 | -------- | |
7791a1d9 | 10 | [verse] |
933c758c | 11 | 'gitk' [<options>] [<revision range>] [--] [<path>...] |
7fc9d69f JH |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
5164b6cd JF |
15 | Displays changes in a repository or a selected set of commits. This includes |
16 | visualizing the commit graph, showing information related to each commit, and | |
17 | the files in the trees of each revision. | |
7fc9d69f | 18 | |
7fc9d69f JH |
19 | OPTIONS |
20 | ------- | |
5164b6cd | 21 | |
744db23c TR |
22 | To control which revisions to show, gitk supports most options |
23 | applicable to the 'git rev-list' command. It also supports a few | |
24 | options applicable to the 'git diff-*' commands to control how the | |
25 | changes each commit introduces are shown. Finally, it supports some | |
26 | gitk-specific options. | |
27 | ||
28 | gitk generally only understands options with arguments in the | |
29 | 'sticked' form (see linkgit:gitcli[7]) due to limitations in the | |
06ab60c0 | 30 | command-line parser. |
744db23c TR |
31 | |
32 | rev-list options and arguments | |
33 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
34 | ||
35 | This manual page describes only the most frequently used options. See | |
36 | linkgit:git-rev-list[1] for a complete list. | |
37 | ||
38 | --all:: | |
39 | ||
40 | Show all refs (branches, tags, etc.). | |
5164b6cd | 41 | |
744db23c TR |
42 | --branches[=<pattern>]:: |
43 | --tags[=<pattern>]:: | |
44 | --remotes[=<pattern>]:: | |
45 | ||
46 | Pretend as if all the branches (tags, remote branches, resp.) | |
47 | are listed on the command line as '<commit>'. If '<pattern>' | |
48 | is given, limit refs to ones matching given shell glob. If | |
49 | pattern lacks '?', '{asterisk}', or '[', '/{asterisk}' at the | |
50 | end is implied. | |
5164b6cd JF |
51 | |
52 | --since=<date>:: | |
53 | ||
54 | Show commits more recent than a specific date. | |
55 | ||
56 | --until=<date>:: | |
57 | ||
58 | Show commits older than a specific date. | |
7fc9d69f | 59 | |
744db23c | 60 | --date-order:: |
44d2775a | 61 | |
744db23c | 62 | Sort commits by date when possible. |
44d2775a | 63 | |
9f1915d3 RQ |
64 | --merge:: |
65 | ||
66 | After an attempt to merge stops with conflicts, show the commits on | |
67 | the history between two branches (i.e. the HEAD and the MERGE_HEAD) | |
3021faf6 SC |
68 | that modify the conflicted files and do not exist on all the heads |
69 | being merged. | |
9f1915d3 | 70 | |
744db23c | 71 | --left-right:: |
29f28151 | 72 | |
27ac8371 | 73 | Mark which side of a symmetric difference a commit is reachable |
744db23c TR |
74 | from. Commits from the left side are prefixed with a `<` |
75 | symbol and those from the right with a `>` symbol. | |
a2df1fb2 | 76 | |
744db23c TR |
77 | --full-history:: |
78 | ||
79 | When filtering history with '<path>...', does not prune some | |
80 | history. (See "History simplification" in linkgit:git-log[1] | |
81 | for a more detailed explanation.) | |
82 | ||
83 | --simplify-merges:: | |
a2df1fb2 | 84 | |
bcf9626a | 85 | Additional option to `--full-history` to remove some needless |
744db23c TR |
86 | merges from the resulting history, as there are no selected |
87 | commits contributing to this merge. (See "History | |
88 | simplification" in linkgit:git-log[1] for a more detailed | |
89 | explanation.) | |
90 | ||
91 | --ancestry-path:: | |
92 | ||
93 | When given a range of commits to display | |
94 | (e.g. 'commit1..commit2' or 'commit2 {caret}commit1'), only | |
95 | display commits that exist directly on the ancestry chain | |
96 | between the 'commit1' and 'commit2', i.e. commits that are | |
97 | both descendants of 'commit1', and ancestors of 'commit2'. | |
98 | (See "History simplification" in linkgit:git-log[1] for a more | |
99 | detailed explanation.) | |
100 | ||
0c1cddd0 | 101 | -L<start>,<end>:<file>:: |
d349e0ee | 102 | -L:<funcname>:<file>:: |
0c1cddd0 TR |
103 | |
104 | Trace the evolution of the line range given by "<start>,<end>" | |
d349e0ee | 105 | (or the function name regex <funcname>) within the <file>. You may |
0c1cddd0 TR |
106 | not give any pathspec limiters. This is currently limited to |
107 | a walk starting from a single revision, i.e., you may only | |
108 | give zero or one positive revision arguments. | |
109 | You can specify this option more than once. | |
110 | + | |
111 | *Note:* gitk (unlike linkgit:git-log[1]) currently only understands | |
112 | this option if you specify it "glued together" with its argument. Do | |
113 | *not* put a space after `-L`. | |
114 | + | |
115 | include::line-range-format.txt[] | |
116 | ||
744db23c | 117 | <revision range>:: |
7fc9d69f | 118 | |
5164b6cd JF |
119 | Limit the revisions to show. This can be either a single revision |
120 | meaning show from the given revision and back, or it can be a range in | |
121 | the form "'<from>'..'<to>'" to show all revisions between '<from>' and | |
122 | back to '<to>'. Note, more advanced revision selection can be applied. | |
41a5564e | 123 | For a more complete list of ways to spell object names, see |
9d83e382 | 124 | linkgit:gitrevisions[7]. |
5164b6cd | 125 | |
f448e24e | 126 | <path>...:: |
5164b6cd JF |
127 | |
128 | Limit commits to the ones touching files in the given paths. Note, to | |
5a4aaaf3 | 129 | avoid ambiguity with respect to revision names use "--" to separate the paths |
3dff5379 | 130 | from any preceding options. |
7fc9d69f | 131 | |
744db23c TR |
132 | gitk-specific options |
133 | ~~~~~~~~~~~~~~~~~~~~~ | |
134 | ||
135 | --argscmd=<command>:: | |
136 | ||
137 | Command to be run each time gitk has to determine the revision | |
138 | range to show. The command is expected to print on its | |
139 | standard output a list of additional revisions to be shown, | |
140 | one per line. Use this instead of explicitly specifying a | |
141 | '<revision range>' if the set of commits to show may vary | |
142 | between refreshes. | |
143 | ||
144 | --select-commit=<ref>:: | |
145 | ||
146 | Select the specified commit after loading the graph. | |
147 | Default behavior is equivalent to specifying '--select-commit=HEAD'. | |
148 | ||
bd663611 LT |
149 | Examples |
150 | -------- | |
151 | gitk v2.6.12.. include/scsi drivers/scsi:: | |
152 | ||
04c8ce9c | 153 | Show the changes since version 'v2.6.12' that changed any |
bd663611 LT |
154 | file in the include/scsi or drivers/scsi subdirectories |
155 | ||
e994004f | 156 | gitk --since="2 weeks ago" \-- gitk:: |
bd663611 LT |
157 | |
158 | Show the changes during the last two weeks to the file 'gitk'. | |
159 | The "--" is necessary to avoid confusion with the *branch* named | |
160 | 'gitk' | |
161 | ||
1d5bf7fc | 162 | gitk --max-count=100 --all \-- Makefile:: |
44d2775a JF |
163 | |
164 | Show at most 100 changes made to the file 'Makefile'. Instead of only | |
165 | looking for changes in the current branch look in all branches. | |
166 | ||
e8095078 CC |
167 | Files |
168 | ----- | |
36dc827b AH |
169 | User configuration and preferences are stored at: |
170 | ||
68ed71b5 CB |
171 | * `$XDG_CONFIG_HOME/git/gitk` if it exists, otherwise |
172 | * `$HOME/.gitk` if it exists | |
36dc827b | 173 | |
68ed71b5 | 174 | If neither of the above exist then `$XDG_CONFIG_HOME/git/gitk` is created and |
36dc827b | 175 | used by default. If '$XDG_CONFIG_HOME' is not set it defaults to |
68ed71b5 | 176 | `$HOME/.config` in all cases. |
e8095078 | 177 | |
744db23c TR |
178 | History |
179 | ------- | |
180 | Gitk was the first graphical repository browser. It's written in | |
b6ca73d9 | 181 | tcl/tk. |
744db23c | 182 | |
b6ca73d9 PO |
183 | 'gitk' is actually maintained as an independent project, but stable |
184 | versions are distributed as part of the Git suite for the convenience | |
185 | of end users. | |
186 | ||
187 | gitk-git/ comes from Paul Mackerras's gitk project: | |
188 | ||
189 | git://ozlabs.org/~paulus/gitk | |
744db23c | 190 | |
56ae8df5 | 191 | SEE ALSO |
5164b6cd JF |
192 | -------- |
193 | 'qgit(1)':: | |
194 | A repository browser written in C++ using Qt. | |
195 | ||
5164b6cd | 196 | 'tig(1)':: |
2de9b711 | 197 | A minimal repository browser and Git tool output highlighter written |
5164b6cd JF |
198 | in C using Ncurses. |
199 | ||
7fc9d69f JH |
200 | GIT |
201 | --- | |
9e1f0a85 | 202 | Part of the linkgit:git[1] suite |