[Bug 5654] New: Help text for clone -r option is unclear

mercurial-bugs at mercurial-scm.org mercurial-bugs at mercurial-scm.org
Sat Aug 12 01:57:32 UTC 2017


https://bz.mercurial-scm.org/show_bug.cgi?id=5654

            Bug ID: 5654
           Summary: Help text for clone -r option is unclear
           Product: Mercurial
           Version: 3.8.4
          Hardware: PC
                OS: Windows
            Status: UNCONFIRMED
          Severity: bug
          Priority: wish
         Component: Mercurial
          Assignee: bugzilla at mercurial-scm.org
          Reporter: david.a.hollman at carrier.utc.com
                CC: mercurial-devel at mercurial-scm.org

The help text shown for the -r option to clone is:

"include the specified changeset"


To the best of my understanding while this is technically a true statement it
does not seem like a complete description of the -r option.

Note - the web documentation at
https://www.selenic.com/mercurial/hg.1.html#clone does give an example where it
explains that -r will "create a repository without changesets after a
particular revision". This seems better, but still a somewhat stilted way of
making the core point.

It would make more sense to me if it said something like "clone up to and
including the specified changeset".

-- 
You are receiving this mail because:
You are on the CC list for the bug.


More information about the Mercurial-devel mailing list