Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(133)

Side by Side Diff: man/man1/git-rebase-update.1

Issue 1331263002: Add a --keep-going flag for people who run rebase-update infrequently. (Closed) Base URL: https://chromium.googlesource.com/chromium/tools/depot_tools.git@master
Patch Set: Fix typo. Created 5 years, 3 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « man/html/git-rebase-update.html ('k') | man/src/git-rebase-update.txt » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
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
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
OLDNEW
« no previous file with comments | « man/html/git-rebase-update.html ('k') | man/src/git-rebase-update.txt » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698