fcm-merge.pod 1.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. =head1 NAME
  2. fcm merge
  3. =head1 SYNOPSIS
  4. Merge changes from a source into your working copy.
  5. 1. fcm merge SOURCE
  6. 2. fcm merge --custom --revision N[:M] SOURCE
  7. fcm merge --custom URL[\@REV1] URL[\@REV2]
  8. 3. fcm merge --reverse --revision [M:]N
  9. =over 4
  10. =item 1.
  11. If neither --custom nor --reverse is specified, the command merges changes
  12. automatically from SOURCE into your working copy. SOURCE must be a valid
  13. URL[@REV] of a branch in a standard FCM project. The base of the merge will be
  14. calculated automatically based on the common ancestor and latest merge
  15. information between the SOURCE and the branch of the working copy.
  16. =item 2.
  17. If --custom is specified, the command can be used in two forms.
  18. In the first form, it performs a custom merge from the specified changeset(s) of
  19. SOURCE into your working copy. SOURCE must be a valid URL[@REV] of a branch in
  20. a standard FCM project. If a single revision is specified, the merge delta is (N
  21. - 1):N of SOURCE. Otherwise, the merge delta, is N:M of SOURCE, where N < M.
  22. In the second form, it performs a custom merge using the delta between the two
  23. specified branch URLs. For each URL, if a peg revision is not specified, the
  24. command will peg the URL with its last changed revision.
  25. =item 3.
  26. If --reverse is specified, the command performs a reverse merge of the
  27. changeset(s) specified by the --revision option. If a single revision is
  28. specified, the merge delta is N:(N - 1). Otherwise, the merge delta is M:N,
  29. where M > N. Note that you do not have to specify a SOURCE for a reverse merge,
  30. because the SOURCE should always be the branch your working copy is pointing to.
  31. =back
  32. The command provide a commit log message template following the merge.
  33. =head1 OPTIONS
  34. =over 4
  35. =item --dry-run
  36. Try operation but make no changes.
  37. =item --non-interactive
  38. Do no interactive prompting.
  39. =item -r [--revision] arg
  40. Specify a (range of) revision number(s).
  41. =item --verbose
  42. Print extra information.
  43. =back
  44. =cut