Fossil SCM

Improved documentation for the --cherrypick and --backout options of the "fossil merge" command.

drh 2019-10-16 17:44 trunk
Commit 29a383e4b6c36c81a0b087fd86d2ec20771c211af27b29b420748b4c967ca748
1 file changed +10 -1
+10 -1
--- src/merge.c
+++ src/merge.c
@@ -195,11 +195,15 @@
195195
**
196196
** Only file content is merged. The result continues to use the
197197
** file and directory names from the current checkout even if those
198198
** names might have been changed in the branch being merged in.
199199
**
200
-** Other options:
200
+** Options:
201
+**
202
+** --backout Do a reverse cherrypick merge against VERSION.
203
+** In other words, back out the changes that were
204
+** added by VERSION.
201205
**
202206
** --baseline BASELINE Use BASELINE as the "pivot" of the merge instead
203207
** of the nearest common ancestor. This allows
204208
** a sequence of changes in a branch to be merged
205209
** without having to merge the entire branch.
@@ -209,10 +213,15 @@
209213
** option overrides the "binary-glob" setting.
210214
**
211215
** --case-sensitive BOOL Override the case-sensitive setting. If false,
212216
** files whose names differ only in case are taken
213217
** to be the same file.
218
+**
219
+** --cherrypick Do a cherrypick merge VERSION into the current
220
+** checkout. A cherrypick merge pulls in the changes
221
+** of the single check-in VERSION, rather than all
222
+** changes back to the nearest common ancestor.
214223
**
215224
** -f|--force Force the merge even if it would be a no-op.
216225
**
217226
** --force-missing Force the merge even if there is missing content.
218227
**
219228
--- src/merge.c
+++ src/merge.c
@@ -195,11 +195,15 @@
195 **
196 ** Only file content is merged. The result continues to use the
197 ** file and directory names from the current checkout even if those
198 ** names might have been changed in the branch being merged in.
199 **
200 ** Other options:
 
 
 
 
201 **
202 ** --baseline BASELINE Use BASELINE as the "pivot" of the merge instead
203 ** of the nearest common ancestor. This allows
204 ** a sequence of changes in a branch to be merged
205 ** without having to merge the entire branch.
@@ -209,10 +213,15 @@
209 ** option overrides the "binary-glob" setting.
210 **
211 ** --case-sensitive BOOL Override the case-sensitive setting. If false,
212 ** files whose names differ only in case are taken
213 ** to be the same file.
 
 
 
 
 
214 **
215 ** -f|--force Force the merge even if it would be a no-op.
216 **
217 ** --force-missing Force the merge even if there is missing content.
218 **
219
--- src/merge.c
+++ src/merge.c
@@ -195,11 +195,15 @@
195 **
196 ** Only file content is merged. The result continues to use the
197 ** file and directory names from the current checkout even if those
198 ** names might have been changed in the branch being merged in.
199 **
200 ** Options:
201 **
202 ** --backout Do a reverse cherrypick merge against VERSION.
203 ** In other words, back out the changes that were
204 ** added by VERSION.
205 **
206 ** --baseline BASELINE Use BASELINE as the "pivot" of the merge instead
207 ** of the nearest common ancestor. This allows
208 ** a sequence of changes in a branch to be merged
209 ** without having to merge the entire branch.
@@ -209,10 +213,15 @@
213 ** option overrides the "binary-glob" setting.
214 **
215 ** --case-sensitive BOOL Override the case-sensitive setting. If false,
216 ** files whose names differ only in case are taken
217 ** to be the same file.
218 **
219 ** --cherrypick Do a cherrypick merge VERSION into the current
220 ** checkout. A cherrypick merge pulls in the changes
221 ** of the single check-in VERSION, rather than all
222 ** changes back to the nearest common ancestor.
223 **
224 ** -f|--force Force the merge even if it would be a no-op.
225 **
226 ** --force-missing Force the merge even if there is missing content.
227 **
228

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button