Subject: Bug#994717: mention return codes on man pages

From: 積丹尼 Dan Jacobson <[email-masked]>
Date: Mon, 20 Sep 2021 03:13:03 +0800

Package: alsa-utils
Version: 1.2.5.1-1
Severity: wishlist
File: /usr/share/man/man1/alsactl.1.gz

Mention something like
   An exit status of zero indicates success, and a nonzero value
   indicates failure.
Else one cannot tell if e.g.,

# alsactl --debug restore; echo $?
alsa-lib parser.c:2372:(load_toplevel_config) Unable to find the top-level configuration file '/usr/share/alsa/ucm2/ucm.conf'.
alsa-lib main.c:1405:(snd_use_case_mgr_open) error: failed to import hw:0 use case configuration -2
alsactl: set_controls:1493: device='hw:0', doit=0
alsactl: set_controls:1505: card-info-id: 'PCH'
alsactl: set_controls:1531: maxnumid=29
alsactl: set_controls:1549: result code: 0
alsactl: set_controls:1493: device='hw:0', doit=1
alsactl: set_controls:1505: card-info-id: 'PCH'
alsactl: set_controls:1531: maxnumid=29
alsactl: set_controls:1549: result code: 0
0

worked or not.