OLD | NEW |
| (Empty) |
1 '\" t | |
2 .\" Title: git-map-branches | |
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\-BRANCHES" "1" "04/10/2014" "depot_tools 68b1017" "Chromium depot_
tools Manual" | |
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-branches \- Helper script to display all local git branches with \(oqups
tream\(cq hierarchy in colorized terminal format\&. | |
32 .SH "SYNOPSIS" | |
33 .sp | |
34 .nf | |
35 \fIgit map\-branches\fR | |
36 .fi | |
37 .sp | |
38 .SH "DESCRIPTION" | |
39 .sp | |
40 Git map\-branches displays all local branches 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 .sp | |
53 .RS 4 | |
54 .ie n \{\ | |
55 \h'-04'\(bu\h'+03'\c | |
56 .\} | |
57 .el \{\ | |
58 .sp -1 | |
59 .IP \(bu 2.3 | |
60 .\} | |
61 The branch which will be modified with git\-commit is denoted with an asterisk (
*) after the name\&. | |
62 .RE | |
63 .RE | |
64 .sp | |
65 .RS 4 | |
66 .ie n \{\ | |
67 \h'-04'\(bu\h'+03'\c | |
68 .\} | |
69 .el \{\ | |
70 .sp -1 | |
71 .IP \(bu 2.3 | |
72 .\} | |
73 Local branches are | |
74 green\&. | |
75 .RE | |
76 .sp | |
77 .RS 4 | |
78 .ie n \{\ | |
79 \h'-04'\(bu\h'+03'\c | |
80 .\} | |
81 .el \{\ | |
82 .sp -1 | |
83 .IP \(bu 2.3 | |
84 .\} | |
85 Remote branches are | |
86 red | |
87 (usually, the root of all other branches)\&. | |
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 {NO UPSTREAM} | |
99 is a special placeholder in | |
100 magenta\&. | |
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 Branches which have this as their parent are usually misconfigured, and should b
e assigned a parent by checking out the branch and running git branch \-\-set\-u
pstream\-to=<correct parent branch>\&. | |
111 .RE | |
112 .RE | |
113 .if n \{\ | |
114 .sp | |
115 .\} | |
116 .RS 4 | |
117 .it 1 an-trap | |
118 .nr an-no-space-flag 1 | |
119 .nr an-break-flag 1 | |
120 .br | |
121 .ps +1 | |
122 \fBNote\fR | |
123 .ps -1 | |
124 .br | |
125 .sp | |
126 If multiple branches are on the same commit, they will all be cyan\&. | |
127 .sp .5v | |
128 .RE | |
129 .SH "EXAMPLE" | |
130 .sp | |
131 Given the hypothetical demo repo in \fBgit-map\fR(1)\*(Aqs EXAMPLE section, and
assuming that the frozen_changes branch was currently checked out, running \fIgi
t map\-branches\fR would result in an output like: | |
132 .sp | |
133 | |
134 .sp | |
135 .if n \{\ | |
136 .RS 4 | |
137 .\} | |
138 .nf | |
139 \fB$ git map\-branches\fR | |
140 origin/master | |
141 cool_feature | |
142 subfeature | |
143 fixit | |
144 \fB frozen_branch * | |
145 \fR{NO UPSTREAM} | |
146 no_upstream | |
147 .fi | |
148 .if n \{\ | |
149 .RE | |
150 .\} | |
151 .sp | |
152 .SH "SUGGESTED ALIASES" | |
153 .sp | |
154 Some common short\-hand aliases\&. Feel free to add these to your \fI~/\&.gitcon
fig\fR file\&. | |
155 .sp | |
156 .if n \{\ | |
157 .RS 4 | |
158 .\} | |
159 .nf | |
160 [alias] | |
161 git bmap = map\-branches | |
162 .fi | |
163 .if n \{\ | |
164 .RE | |
165 .\} | |
166 .sp | |
167 .SH "SEE ALSO" | |
168 .sp | |
169 \fBgit-map\fR(1) | |
170 .SH "CHROMIUM DEPOT_TOOLS" | |
171 .sp | |
172 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\&. | |
173 .SH "NOTES" | |
174 .IP " 1." 4 | |
175 here | |
176 .RS 4 | |
177 \%https://chromium.googlesource.com/chromium/tools/depot_tools.git | |
178 .RE | |
OLD | NEW |