OLD | NEW |
1 '\" t | 1 '\" t |
2 .\" Title: git-rebase-update | 2 .\" Title: git-rebase-update |
3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] | 3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] |
4 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> | 4 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> |
5 .\" Date: 04/10/2014 | 5 .\" Date: 09/10/2015 |
6 .\" Manual: Chromium depot_tools Manual | 6 .\" Manual: Chromium depot_tools Manual |
7 .\" Source: depot_tools 68b1017 | 7 .\" Source: depot_tools 805792e |
8 .\" Language: English | 8 .\" Language: English |
9 .\" | 9 .\" |
10 .TH "GIT\-REBASE\-UPDATE" "1" "04/10/2014" "depot_tools 68b1017" "Chromium depot
_tools Manual" | 10 .TH "GIT\-REBASE\-UPDATE" "1" "09/10/2015" "depot_tools 805792e" "Chromium depot
_tools Manual" |
11 .\" ----------------------------------------------------------------- | 11 .\" ----------------------------------------------------------------- |
12 .\" * Define some portability stuff | 12 .\" * Define some portability stuff |
13 .\" ----------------------------------------------------------------- | 13 .\" ----------------------------------------------------------------- |
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
15 .\" http://bugs.debian.org/507673 | 15 .\" http://bugs.debian.org/507673 |
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html | 16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html |
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | 17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
18 .ie \n(.g .ds Aq \(aq | 18 .ie \n(.g .ds Aq \(aq |
19 .el .ds Aq ' | 19 .el .ds Aq ' |
20 .\" ----------------------------------------------------------------- | 20 .\" ----------------------------------------------------------------- |
21 .\" * set default formatting | 21 .\" * set default formatting |
22 .\" ----------------------------------------------------------------- | 22 .\" ----------------------------------------------------------------- |
23 .\" disable hyphenation | 23 .\" disable hyphenation |
24 .nh | 24 .nh |
25 .\" disable justification (adjust text to left margin only) | 25 .\" disable justification (adjust text to left margin only) |
26 .ad l | 26 .ad l |
27 .\" ----------------------------------------------------------------- | 27 .\" ----------------------------------------------------------------- |
28 .\" * MAIN CONTENT STARTS HERE * | 28 .\" * MAIN CONTENT STARTS HERE * |
29 .\" ----------------------------------------------------------------- | 29 .\" ----------------------------------------------------------------- |
30 .SH "NAME" | 30 .SH "NAME" |
31 git-rebase-update \- Updates all branches to have the latest changes from their
upstreams\&. | 31 git-rebase-update \- Updates all branches to have the latest changes from their
upstreams\&. |
32 .SH "SYNOPSIS" | 32 .SH "SYNOPSIS" |
33 .sp | 33 .sp |
34 .nf | 34 .nf |
35 \fIgit rebase\-update\fR [\-v | \-\-verbose] [\-n | \-\-no_fetch] | 35 \fIgit rebase\-update\fR [\-v | \-\-verbose] [\-n | \-\-no\-fetch] [\-k | \-\-ke
ep\-going] |
36 .fi | 36 .fi |
37 .sp | 37 .sp |
38 .SH "DESCRIPTION" | 38 .SH "DESCRIPTION" |
39 .sp | 39 .sp |
40 Brings all branches up\-to\-date with their tracking branches\&. This involves s
everal phases: | 40 Brings all branches up\-to\-date with their tracking branches\&. This involves s
everal phases: |
41 .PP | 41 .PP |
42 Preparation | 42 Preparation |
43 .RS 4 | 43 .RS 4 |
44 If you currently have a branch checked out, any changes on that branch are | 44 If you currently have a branch checked out, any changes on that branch are |
45 \fIfrozen\fR | 45 \fIfrozen\fR |
46 (See | 46 (See |
47 \fBgit-freeze\fR(1) | 47 \fBgit-freeze\fR(1) |
48 for more detail)\&. Additionally, the current branch is recorded for the | 48 for more detail)\&. Additionally, the current branch is recorded for the |
49 \fIRestoration\fR | 49 \fIRestoration\fR |
50 phase later (see | 50 phase later (see |
51 \fICONFIGURATION VARIABLES\fR | 51 \fICONFIGURATION VARIABLES\fR |
52 for details on | 52 for details on |
53 depot\-tools\&.rebase\-update\&.starting\-branch)\&. | 53 depot\-tools\&.rebase\-update\&.starting\-branch)\&. |
54 .RE | 54 .RE |
55 .PP | 55 .PP |
56 Fetching | 56 Fetching |
57 .RS 4 | 57 .RS 4 |
58 All branches are examined to find their upstream references\&. The correct set o
f git remotes is determined, and fetched accordingly\&. Note that if any branche
s have a tag as their upstream, we are forced to pull all remotes\&. | 58 All branches are examined to find their upstream references\&. The correct set o
f git remotes is determined, and fetched accordingly\&. Note that if any branche
s have a tag as their upstream, we are forced to pull all remotes\&. |
59 .sp | 59 .sp |
60 Pass | 60 Pass |
61 \-\-no_fetch | 61 \-\-no\-fetch |
62 to skip this phase\&. | 62 to skip this phase\&. |
63 .RE | 63 .RE |
64 .PP | 64 .PP |
65 Rebasing | 65 Rebasing |
66 .RS 4 | 66 .RS 4 |
67 All branches are rebased in topological order from roots (upstreams) to leaves\&
. Each branch is rebased from its marked merge\-base (see | 67 All branches are rebased in topological order from roots (upstreams) to leaves\&
. Each branch is rebased from its marked merge\-base (see |
68 \fICONFIGURATION VARIABLES\fR) to the branch tip on top of its parent branch\&.
If the parent branch is | 68 \fICONFIGURATION VARIABLES\fR) to the branch tip on top of its parent branch\&.
If the parent branch is |
69 \fIfrozen\fR | 69 \fIfrozen\fR |
70 (see | 70 (see |
71 \fBgit-freeze\fR(1)), the branch will be rebased onto the last non\-freeze commi
t on the parent branch\&. | 71 \fBgit-freeze\fR(1)), the branch will be rebased onto the last non\-freeze commi
t on the parent branch\&. |
72 .sp | 72 .sp |
73 Things get interesting when there are merge conflicts on rebase\&. The | 73 Things get interesting when there are merge conflicts on rebase\&. The |
74 \fBmost common\fR | 74 \fBmost common\fR |
75 cause for conflicts is when your branch has been committed to the upstream in sq
uashed form, ala | 75 cause for conflicts is when your branch has been committed to the upstream in sq
uashed form, ala |
76 \fBgit-squash-branch\fR(1), which is what | 76 \fBgit-squash-branch\fR(1), which is what |
77 \fBgit-cl\fR(1) | 77 \fBgit-cl\fR(1) |
78 and the | 78 and the |
79 \fICommit Queue\fR | 79 \fICommit Queue\fR |
80 will do\&. Because of that, | 80 will do\&. Because of that, |
81 git rebase\-update | 81 git rebase\-update |
82 will attempt to squash your conflicted branch to see if the squashed version app
lies cleanly to its upstream\&. | 82 will attempt to squash your conflicted branch to see if the squashed version app
lies cleanly to its upstream\&. |
83 .sp | 83 .sp |
84 If it does not apply cleanly, then your original (non\-squashed) branch will be
left in mid\-rebase and | 84 If it does not apply cleanly, then your original (non\-squashed) branch will be
left in mid\-rebase and |
85 git rebase\-update | 85 git rebase\-update |
86 will exit\&. You can deal with this like any other conflicted rebase\&. When you
\(cqre done, just | 86 will exit\&. You can deal with this like any other conflicted rebase\&. When you
\(cqre done, just |
87 git rebase\-update | 87 git rebase\-update |
88 again to pick up where you left off\&. | 88 again to pick up where you left off\&. |
89 .RE | 89 .RE |
| 90 .sp |
| 91 If you\(cqd like to rebase all rebaseable branches in one pass and manually proc
ess the unrebaseable ones later, use \-k or \-\-keep\-going\&. Cleanup will not
happen until all branches apply cleanly\&. |
90 .PP | 92 .PP |
91 Cleanup | 93 Cleanup |
92 .RS 4 | 94 .RS 4 |
93 Once all the branches have been rebased, any empty branches (i\&.e\&. branches w
ith no commits on them) are removed\&. If a branch is removed in this fashion, a
ny branches which depend on it are reparented to the parent of the removed branc
h (see | 95 Once all the branches have been rebased, any empty branches (i\&.e\&. branches w
ith no commits on them) are removed\&. If a branch is removed in this fashion, a
ny branches which depend on it are reparented to the parent of the removed branc
h (see |
94 \fBgit-reparent-branch\fR(1))\&. | 96 \fBgit-reparent-branch\fR(1))\&. |
95 .RE | 97 .RE |
96 .PP | 98 .PP |
97 Restoration | 99 Restoration |
98 .RS 4 | 100 .RS 4 |
99 git rebase\-update | 101 git rebase\-update |
100 checks out the branch that you started on, and | 102 checks out the branch that you started on, and |
101 \fIthaws\fR | 103 \fIthaws\fR |
102 it, if necessary (see | 104 it, if necessary (see |
103 \fBgit-thaw\fR(1))\&. If the branch you started on got cleaned up, | 105 \fBgit-thaw\fR(1))\&. If the branch you started on got cleaned up, |
104 git rebase\-update | 106 git rebase\-update |
105 will checkout the | 107 will checkout the |
106 \fIroot\fR | 108 \fIroot\fR |
107 ref (defaults to | 109 ref (defaults to |
108 \fIorigin/master\fR, as configured by | 110 \fIorigin/master\fR, as configured by |
109 depot\-tools\&.upstream, see | 111 depot\-tools\&.upstream, see |
110 \fBgit-new-branch\fR(1))\&. | 112 \fBgit-new-branch\fR(1))\&. |
111 .RE | 113 .RE |
112 .SH "OPTIONS" | 114 .SH "OPTIONS" |
113 .PP | 115 .PP |
114 \-n, \-\-no_fetch | 116 \-n, \-\-no\-fetch |
115 .RS 4 | 117 .RS 4 |
116 Skip the | 118 Skip the |
117 git fetch | 119 git fetch |
118 phase of rebase\-update\&. | 120 phase of rebase\-update\&. |
119 .RE | 121 .RE |
120 .PP | 122 .PP |
121 \-v, \-\-verbose | 123 \-v, \-\-verbose |
122 .RS 4 | 124 .RS 4 |
123 More text than your terminal can handle\&. | 125 More text than your terminal can handle\&. |
124 .RE | 126 .RE |
(...skipping 31 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
156 \fBgit-new-branch\fR(1), \fBgit-reparent-branch\fR(1), \fBgit-rename-branch\fR(1
), \fBgit-upstream-diff\fR(1), \fBgit-freeze\fR(1), \fBgit-mark-merge-base\fR(1) | 158 \fBgit-new-branch\fR(1), \fBgit-reparent-branch\fR(1), \fBgit-rename-branch\fR(1
), \fBgit-upstream-diff\fR(1), \fBgit-freeze\fR(1), \fBgit-mark-merge-base\fR(1) |
157 .SH "CHROMIUM DEPOT_TOOLS" | 159 .SH "CHROMIUM DEPOT_TOOLS" |
158 .sp | 160 .sp |
159 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\&. | 161 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\&. |
160 .SH "NOTES" | 162 .SH "NOTES" |
161 .IP " 1." 4 | 163 .IP " 1." 4 |
162 here | 164 here |
163 .RS 4 | 165 .RS 4 |
164 \%https://chromium.googlesource.com/chromium/tools/depot_tools.git | 166 \%https://chromium.googlesource.com/chromium/tools/depot_tools.git |
165 .RE | 167 .RE |
OLD | NEW |