proposal to change "hg rebase" description

anatoly techtonik techtonik at gmail.com
Sun Dec 1 15:12:22 CST 2013


This is very git-like, i.e. hard to understand:


hg rebase [-s REV | -b REV] [-d REV] [OPTION]

move changeset (and descendants) to a different branch

    Rebase uses repeated merging to graft changesets from one part of history
    (the source) onto another (the destination). This can be useful for
    linearizing *local* changes relative to a master development tree.


How about?


hg rebase [-s REV | -b REV] [-d REV] [OPTION]

move specified changeset with descendants on top of different base revision

    Rebase moves changesets starting at one point of history tree (the source)
    onto another (the destination) by gradually passing them through revisions
    that lead to this different place. This is often used to
streamline history by
    moving private local changes on top of a public commits from master repo.


Please, CC.
--
anatoly t.


More information about the Mercurial-devel mailing list