"bzr missing" should document return code meanings

[Gleb Shchepa]

 $ cd some-branch
 $ bzr missing
some output from bzr
 $ echo $? # this always prints 1 instead of 0
1

$ bzr version
Bazaar (bzr) 1.10
  Python interpreter: /usr/bin/python 2.5.2

[Vincent Ladeuil (vila)]

bzr missing returns 0 if nothing is missing and 1 if something is missing

[Gleb Shchepa (gleb-mysql)]

vila, do you know where is it documented?

[Vincent Ladeuil (vila)]

The best documentation I can find is in bzrlib.tests.blackbox.test_missing :->

[GuilhemBichot (guilhem-bichot)]

Salut Vincent. Yes, the return code rules of "bzr missing" is something I found by looking at code too; we see here that this is not sufficient documentation; it would be much better to have it mentioned in "bzr help missing" if possible. Thank you for considering this request.

[Aaron Bentley (abentley)]

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

Gleb Shchepa wrote:
> Public bug reported:
>
> $ cd some-brach
> $ bzr missing
> some output from bzr
> $ echo $? # this always prints 1 instead of 0
> 1

This is the common status code policy for bzr. You'll find the same
thing with "bzr diff" as well.

Aaron
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAkl1MiwACgkQ0F+nu1YWqI2lRgCePRSJdKCfHDQ4IkeHKFsANOUP
a4kAniUrV1qVEGc8zrl27o5/uQrbf/yk
=PUOf
-----END PGP SIGNATURE-----

[Vincent Ladeuil (vila)]

The doc for missing should mention the different values as diff does

[SabreWolfy (sabrewolfy)]

This is marked as fixed in 2.1.0b4. Where can I find a list of the return codes and what they mean?

[SabreWolfy (sabrewolfy)]

Partial answer here from February 2012:

http://comments.gmane.org/gmane.comp.version-control.bazaar-ng.general/73804

[Neil Martinsen-Burrell (nmb)]

From "bzr help missing":

"""
Exit values:
    1 - some missing revisions
    0 - no missing revisions
"""

Is there somewhere else that you would like to see this documented?
Some change to the language used that would make it more transparent
to you?

On Mon, Jul 23, 2012 at 8:29 AM, SabreWolfy <email address hidden> wrote:
> Partial answer here from February 2012:
>
> http://comments.gmane.org/gmane.comp.version-control.bazaar-
> ng.general/73804
>
> --
> You received this bug notification because you are a bug assignee.
> https://bugs.launchpad.net/bugs/308651
>
> Title:
> "bzr missing" should document return code meanings
>
> To manage notifications about this bug go to:
> https://bugs.launchpad.net/bzr/+bug/308651/+subscriptions

[SabreWolfy (sabrewolfy)]

Thanks. I meant that it would be useful to have a list of return/exit codes to all commands, not just for "missing". Running "bzr help update" for example, does not include a list of return codes for that command.