[Python-apps-team] Bug#611420: hg.1: description of backout command is confusing

[Jonathan Nieder]

Javi Merino wrote:

> Maybe this is better worded than the backout description, but I don't
> really see what is wrong with the original one. Propose your change in
> mercurial-devel at selenic.com and discuss it there, but I think
> "changeset", "merge" and "revert" are common concepts of VCSs, hence
> tagging this bug wontfix.

Sorry, I took a long time to get to the point, which was:

>> | Note that the default behavior (without --merge) has changed in
>> | version 1.7.  To restore the previous behavior, [...]
>> 
>> And what is the new default behavior?

In other words, if you ignore the details and just try to read the
description like a person not knowing what "hg backout" does (I still
don't know), then the description doesn't tell you.  That's even after
reading the glossary.

Jonathan