OLD | NEW |
| (Empty) |
1 '\" t | |
2 .\" Title: git-map | |
3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] | |
4 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> | |
5 .\" Date: 04/10/2014 | |
6 .\" Manual: Chromium depot_tools Manual | |
7 .\" Source: depot_tools 68b1017 | |
8 .\" Language: English | |
9 .\" | |
10 .TH "GIT\-MAP" "1" "04/10/2014" "depot_tools 68b1017" "Chromium depot_tools Manu
al" | |
11 .\" ----------------------------------------------------------------- | |
12 .\" * Define some portability stuff | |
13 .\" ----------------------------------------------------------------- | |
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
15 .\" http://bugs.debian.org/507673 | |
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html | |
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
18 .ie \n(.g .ds Aq \(aq | |
19 .el .ds Aq ' | |
20 .\" ----------------------------------------------------------------- | |
21 .\" * set default formatting | |
22 .\" ----------------------------------------------------------------- | |
23 .\" disable hyphenation | |
24 .nh | |
25 .\" disable justification (adjust text to left margin only) | |
26 .ad l | |
27 .\" ----------------------------------------------------------------- | |
28 .\" * MAIN CONTENT STARTS HERE * | |
29 .\" ----------------------------------------------------------------- | |
30 .SH "NAME" | |
31 git-map \- Display history of all branches in a colorized terminal format\&. | |
32 .SH "SYNOPSIS" | |
33 .sp | |
34 .nf | |
35 \fIgit map\fR [<extra_args>\&...] | |
36 .fi | |
37 .sp | |
38 .SH "DESCRIPTION" | |
39 .sp | |
40 Git map formats the output of git log \-\-graph from all refs such that: | |
41 .sp | |
42 .RS 4 | |
43 .ie n \{\ | |
44 \h'-04'\(bu\h'+03'\c | |
45 .\} | |
46 .el \{\ | |
47 .sp -1 | |
48 .IP \(bu 2.3 | |
49 .\} | |
50 Current branch is | |
51 cyan\&. | |
52 .RE | |
53 .sp | |
54 .RS 4 | |
55 .ie n \{\ | |
56 \h'-04'\(bu\h'+03'\c | |
57 .\} | |
58 .el \{\ | |
59 .sp -1 | |
60 .IP \(bu 2.3 | |
61 .\} | |
62 Local branches are | |
63 green\&. | |
64 .RE | |
65 .sp | |
66 .RS 4 | |
67 .ie n \{\ | |
68 \h'-04'\(bu\h'+03'\c | |
69 .\} | |
70 .el \{\ | |
71 .sp -1 | |
72 .IP \(bu 2.3 | |
73 .\} | |
74 Remote branches are | |
75 red\&. | |
76 .RE | |
77 .sp | |
78 .RS 4 | |
79 .ie n \{\ | |
80 \h'-04'\(bu\h'+03'\c | |
81 .\} | |
82 .el \{\ | |
83 .sp -1 | |
84 .IP \(bu 2.3 | |
85 .\} | |
86 Tags are | |
87 magenta\&. | |
88 .RE | |
89 .sp | |
90 .RS 4 | |
91 .ie n \{\ | |
92 \h'-04'\(bu\h'+03'\c | |
93 .\} | |
94 .el \{\ | |
95 .sp -1 | |
96 .IP \(bu 2.3 | |
97 .\} | |
98 Merge Base markers are | |
99 white\&. | |
100 .RE | |
101 .sp | |
102 .RS 4 | |
103 .ie n \{\ | |
104 \h'-04'\(bu\h'+03'\c | |
105 .\} | |
106 .el \{\ | |
107 .sp -1 | |
108 .IP \(bu 2.3 | |
109 .\} | |
110 The currently checked out commit is highlighted with a | |
111 blue background\&. | |
112 .RE | |
113 .sp | |
114 The output is automatically piped through the less pager command, even on window
s\&. | |
115 .SH "OPTIONS" | |
116 .PP | |
117 <extra_args>\&... | |
118 .RS 4 | |
119 Extra parameters to pass to the internal | |
120 \fBgit-log\fR(1) | |
121 invocation\&. This can be used to restrict what refs | |
122 \fIgit map\fR | |
123 operates on, etc\&. | |
124 .sp | |
125 If you run git map with a series of fixed arguments frequently, you can use the
depot\-tools\&.map\-extra configuration variable to pre\-set arguments (See | |
126 CONFIGURATION VARIABLES) | |
127 .RE | |
128 .SH "CONFIGURATION VARIABLES" | |
129 .SS "depot\-tools\&.map\-extra" | |
130 .sp | |
131 Each value of the \fIdepot\-tools\&.map\-extra\fR config variable is applied as
an additional argument to git log during the execution of git map\&. If you wish
to configure this, use git config \-\-add depot\-tools\&.map\-extra <value> to
do so\&. | |
132 .SH "EXAMPLE" | |
133 .sp | |
134 Running \fIgit map\fR would result in an output something like: | |
135 .sp | |
136 .if n \{\ | |
137 .RS 4 | |
138 .\} | |
139 .nf | |
140 \fB$ git map\fR | |
141 \fB* d0fb9c7 \fR (\fBfrozen_branch\fR) 2014\-04\-10 ~ FREEZE\&.unindexed | |
142 * \fBf48f415 \fR 2014\-04\-10 ~ modfile | |
143 * \fB4c5b9c0 \fR 2014\-04\-10 ~ a deleted file | |
144 * \fBf7ce1e4 \fR (\fBfixit\fR) 2014\-04\-10 ~ Add neat feature\fB <(frozen
_branch)\fR | |
145 * \fB3726937 \fR 2014\-04\-10 ~ Epic README update | |
146 | * \fB14db2e5 \fR (\fBcool_feature\fR) 2014\-04\-10 ~ Respond to CL comments | |
147 | | * \fBee3f972 \fR (\fBsubfeature\fR) 2014\-04\-10 ~ integrate with Coo
lService | |
148 | | * \fB4f9f508 \fR 2014\-04\-10 ~ slick commenting action | |
149 | |/ | |
150 | * \fB7d84f85 \fR 2014\-04\-10 ~ another improvement\fB <(subfeature)\fR | |
151 | * \fB27abea4 \fR (\fBspleen_tag\fR) 2014\-04\-10 ~ Refactor spleen | |
152 | * \fBd8abe73 \fR 2014\-04\-10 ~ Add widget | |
153 |/ | |
154 * \fBbeec6f4 \fR (origin/master, origin/HEAD) 2014\-04\-10 ~ Make ReflectorIm
pl use mailboxes\fB <(cool_feature, fixit)\fR | |
155 * \fB41290e0 \fR 2014\-04\-10 ~ don\*(Aqt use glibc\-specific execinfo\&.h on
uclibc builds | |
156 * \fBa76fde7 \fR 2014\-04\-10 ~ [fsp] Add requestUnmount() method together wi
th the request manager\&. | |
157 * \fB9de7a71 \fR 2014\-04\-10 ~ linux_aura: Use system configuration for midd
le clicking the titlebar\&. | |
158 * \fB073b0c2 \fR 2014\-04\-10 ~ ContentView\->ContentViewCore in ContentViewR
enderView | |
159 * \fB2250f53 \fR 2014\-04\-10 ~ ozone: evdev: Filter devices by path | |
160 * \fB33a7a74 \fR 2014\-04\-10 ~ Always output seccomp error messages to stder
r | |
161 .fi | |
162 .if n \{\ | |
163 .RE | |
164 .\} | |
165 .sp | |
166 .sp | |
167 As you can see, the structure of the commit history is visible, particularly wha
t the parents of each commit are\&. In order to see the \fIupstream\fR relations
hips of the branches (i\&.e\&. which branch is tracking which other branch), use
the \fBgit-map-branches\fR(1) command\&. | |
168 .SH "SEE ALSO" | |
169 .sp | |
170 \fBgit-map-branches\fR(1) | |
171 .SH "CHROMIUM DEPOT_TOOLS" | |
172 .sp | |
173 Part of the chromium \fBdepot_tools\fR(7) suite\&. These tools are meant to assi
st with the development of chromium and related projects\&. Download the tools f
rom \m[blue]\fBhere\fR\m[]\&\s-2\u[1]\d\s+2\&. | |
174 .SH "NOTES" | |
175 .IP " 1." 4 | |
176 here | |
177 .RS 4 | |
178 \%https://chromium.googlesource.com/chromium/tools/depot_tools.git | |
179 .RE | |
OLD | NEW |