BAT: Change comments and interface of usage()

1. Change comment strings to make the descriptions more clear;
2. Add indent for option lines that have no indent;
3. Use a const string instead of argv[0] as program name.

Signed-off-by: Lu, Han <han.lu@intel.com>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
This commit is contained in:
Lu, Han 2015-10-20 16:45:47 +08:00 committed by Takashi Iwai
parent 8c910830f0
commit 5a48606d94

View file

@ -268,28 +268,27 @@ static void test_capture(struct bat *bat)
} }
} }
static void usage(struct bat *bat, char *argv[]) static void usage(struct bat *bat)
{ {
fprintf(bat->log, fprintf(bat->log,
_("Usage:%s [Option]...\n" _("Usage: bat [-options]...\n"
"\n" "\n"
"-h, --help help\n" " -h, --help this help\n"
"-D sound card\n" " -D pcm device for both playback and capture\n"
"-P playback pcm\n" " -P pcm device for playback\n"
"-C capture pcm\n" " -C pcm device for capture\n"
"-f sample size\n" " -f sample format\n"
"-c number of channels\n" " -c number of channels\n"
"-r sampling rate\n" " -r sampling rate\n"
"-n frames to capture\n" " -n frames to playback or capture\n"
"-k sigma k\n" " -k parameter for frequency detecting threshold\n"
"-F target frequency\n" " -F target frequency\n"
"-p total number of periods to play/capture\n" " -p total number of periods to play/capture\n"
" --log=# path of log file. if not set, logs be put to stdout,\n" " --log=# file that both stdout and strerr redirecting to\n"
" and errors be put to stderr.\n" " --file=# file for playback\n"
" --file=# input file\n" " --saveplay=# file that storing playback content, for debug\n"
" --saveplay=# save playback content to target file, for debug\n" " --local internal loop, set to bypass pcm hardware devices\n"
" --local internal loop, bypass hardware\n" ));
), argv[0]);
fprintf(bat->log, _("Recognized sample formats are: %s %s %s %s\n"), fprintf(bat->log, _("Recognized sample formats are: %s %s %s %s\n"),
snd_pcm_format_name(SND_PCM_FORMAT_U8), snd_pcm_format_name(SND_PCM_FORMAT_U8),
snd_pcm_format_name(SND_PCM_FORMAT_S16_LE), snd_pcm_format_name(SND_PCM_FORMAT_S16_LE),
@ -401,7 +400,7 @@ static void parse_arguments(struct bat *bat, int argc, char *argv[])
break; break;
case 'h': case 'h':
default: default:
usage(bat, argv); usage(bat);
exit(EXIT_SUCCESS); exit(EXIT_SUCCESS);
} }
} }