27 def rebase(ui, repo, **opts): |
27 def rebase(ui, repo, **opts): |
28 """move changeset (and descendants) to a different branch |
28 """move changeset (and descendants) to a different branch |
29 |
29 |
30 Rebase uses repeated merging to graft changesets from one part of |
30 Rebase uses repeated merging to graft changesets from one part of |
31 history (the source) onto another (the destination). This can be |
31 history (the source) onto another (the destination). This can be |
32 useful for linearizing local changes relative to a master |
32 useful for linearizing *local* changes relative to a master |
33 development tree. |
33 development tree. |
|
34 |
|
35 You should not rebase changesets that have already been shared |
|
36 with others. Doing so will force everybody else to perform the |
|
37 same rebase or they will end up with duplicated changesets after |
|
38 pulling in your rebased changesets. |
34 |
39 |
35 If you don't specify a destination changeset (``-d/--dest``), |
40 If you don't specify a destination changeset (``-d/--dest``), |
36 rebase uses the tipmost head of the current named branch as the |
41 rebase uses the tipmost head of the current named branch as the |
37 destination. (The destination changeset is not modified by |
42 destination. (The destination changeset is not modified by |
38 rebasing, but new changesets are added as its descendants.) |
43 rebasing, but new changesets are added as its descendants.) |