bzr revert --help doesn't mention bzr revert's -r option

[Matthew Paul Thomas]

bzr revert -rY..X FILE reverts the changes made to FILE between revisions X and Y. However, bzr revert --help doesn't mention this.

[Aaron Bentley (abentley)]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Matthew Paul Thomas wrote:
> Public bug reported:
>
> bzr revert -rY..X FILE reverts the changes made to FILE between
> revisions X and Y.

Actually, revert -r only accepts one argument, not two. Revert doesn't
revert changes, it reverts the tree or file(s) to the state it was in at
a given revision (the last one, by default).

> However, bzr revert --help doesn't mention this.

All options* are necessarily documented, because of the way the help
messages are generated. The -r documentation is on the last line of the
help message:
  -r ARG, --revision=ARG

This is consistent with all commands that take -r, e.g. diff, status,
merge. I would agree that the documentation could be improved, though.

Aaron
* except special global options like --no-plugins, --no-aliases, etc.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org

iD8DBQFFETkn0F+nu1YWqI0RAg56AJ4kFcPO3AgmyV9VC54bChlTVLR42wCcCGTo
Ey4kzxbvdXtobo4PCnC6za8=
=Rylo
-----END PGP SIGNATURE-----

[Aaron Bentley (abentley)]

I've submitted a change to the help text that should make things clearer.

[Matthew Paul Thomas (mpt)]

Thanks, and sorry for not noticing that it was mentioned at all. :-)