proposal to change "hg rebase" description

Bryan O'Sullivan bos at serpentine.com
Tue Dec 3 00:21:06 UTC 2013


On Sun, Dec 1, 2013 at 1:12 PM, anatoly techtonik <techtonik at gmail.com>wrote:

>     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.
>

I agree that the original wording is not easy to understand, but your
proposed wording above makes it harder to follow - I don't know what
"gradually passing them through revisions that lead to this different
place" means. I think that if you drop this part of the first sentence,
it's a net improvement - a reader will care what the command does, and the
how can get buried somewhere later.

So here's what I think the first sentence should be: "Rebase moves
changesets from one place in the history tree (the source) to another (the
destination)."


> This is often used to streamline history by moving private local changes
> on top of a public commits from master repo.
>

This is a bit awkward, too, but I don't have a quick suggestion on how to
improve it.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mercurial-scm.org/pipermail/mercurial-devel/attachments/20131202/1a78feb0/attachment-0002.html>


More information about the Mercurial-devel mailing list