| 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 |