Syntax for "hg fold"

Greg Ward greg at gerg.ca
Mon Jun 2 23:32:57 UTC 2014


Folks --

I'm finding it awkward to document "hg fold". Expressing "it takes a
single revision R, and folds R::. into a successor" in clear, concise
English is tricky.

In my experience, if an interface is difficult to explain, it's
probably not the right interface. So I humbly propose a UI change:

  hg fold REV...

  Fold multiple revisions into a single one

    Combines the specified revisions into one, which becomes successor
    to all input revisions.

Or perhaps it should be

  hg fold [-r] REV...

since the "optional -r" is a fairly common pattern for commands that
primarily take a revision or revset.

       Greg
-- 
Greg Ward                            http://www.gerg.ca
<greg at gerg.ca>                       @gergdotca



More information about the Evolve-testers mailing list