/*
* NAME: show_usage()
* DESCRIPTION: display usage message
*/
static
void show_usage(int verbose)
{
FILE *stream = verbose ? stdout : stderr;
fprintf(stream, _("Usage: %s [OPTIONS] FILE [...]\n"), argv0);
if (!verbose) {
fprintf(stream, _("Try `%s --help' for more information.\n"), argv0);
return;
}
EPUTS(_("Display or modify ID3 tags in FILE(s).\n"));
/* the following usage text should agree with the option names */
EPUTS(_("\nMiscellaneous:\n"));
EPUTS(_(" -V, --version display version number and exit\n"));
EPUTS(_(" -h, --help display this help and exit\n"));
}
/*
* NAME: show_usage()
* DESCRIPTION: display usage message
*/
static
void show_usage(int verbose)
{
FILE *stream = verbose ? stdout : stderr;
fprintf(stream, _("Usage: %s [OPTIONS] FILE [...]\n"), argv0);
if (!verbose) {
fprintf(stream, _("Try `%s --help' for more information.\n"), argv0);
return;
}
EPUTS(_("Decode and play MPEG audio FILE(s).\n"));
/* the following usage text should agree with the option names */
EPUTS(_("\nVerbosity:\n"));
EPUTS(_(" -v, --verbose show status while decoding\n"));
EPUTS(_(" -q, --quiet be quiet but show warnings\n"));
EPUTS(_(" -Q, --very-quiet "
"be quiet and do not show warnings\n"));
EPUTS(_(" --display-time=MODE "
"use default verbose time display MODE\n"
" (remaining, current, overall)\n"));
EPUTS(_("\nDecoding:\n"));
EPUTS(_(" --downsample reduce sample rate 2:1\n"));
EPUTS(_(" -i, --ignore-crc ignore CRC errors\n"));
EPUTS(_(" --ancillary-output=PATH write ancillary data to PATH\n"));
EPUTS(_("\nAudio output:\n"));
EPUTS(_(" -o, --output=[TYPE:]PATH "
"write output to PATH with format TYPE (below)\n"));
EPUTS(_(" -b, --bit-depth=DEPTH request DEPTH bits per sample\n"));
EPUTS(_(" -R, --sample-rate=HERTZ "
"request HERTZ samples per second\n"));
EPUTS(_(" -d, --no-dither "
"do not dither output PCM samples\n"));
fprintf(stream,
_(" --fade-in[=DURATION] "
"fade-in songs over DURATION (default %s)\n"), FADE_DEFAULT);
# if 0
fprintf(stream,
_(" --fade-out[=DURATION] "
"fade-out songs over DURATION (default %s)\n"), FADE_DEFAULT);
EPUTS(_(" -g, --gap=DURATION set inter-song gap to DURATION\n"));
EPUTS(_(" -x, --cross-fade "
"cross-fade songs (use with negative gap)\n"));
# endif
EPUTS(_(" -a, --attenuate=DECIBELS "
"attenuate signal by DECIBELS (-)\n"));
EPUTS(_(" -a, --amplify=DECIBELS amplify signal by DECIBELS (+)\n"));
EPUTS(_(" -A, --adjust-volume=DECIBELS "
"override per-file volume adjustments\n"));
EPUTS(_(" -G, --replay-gain[=PROFILE] "
"enable Replay Gain volume adjustments using\n"
" PROFILE (radio, audiophile)\n"));
EPUTS(_("\nChannel selection:\n"));
EPUTS(_(" -1, --left "
"output first (left) channel only\n"));
EPUTS(_(" -2, --right "
"output second (right) channel only\n"));
EPUTS(_(" -m, --mono "
"mix left and right channels for monaural output\n"));
EPUTS(_(" -S, --stereo force stereo output\n"));
# if defined(EXPERIMENTAL)
EPUTS(_("\nExperimental:\n"));
EPUTS(_(" --external-mix "
"output pre-synthesis samples for external mixer\n"));
EPUTS(_(" --experimental enable experimental filter\n"));
# endif
EPUTS(_("\nPlayback:\n"));
EPUTS(_(" -s, --start=TIME "
"skip to begin at TIME (HH:MM:SS.DDD)\n"));
EPUTS(_(" -t, --time=DURATION "
"play only for DURATION (HH:MM:SS.DDD)\n"));
EPUTS(_(" -z, --shuffle randomize file list\n"));
EPUTS(_(" -r, --repeat[=MAX] "
"play files MAX times, or indefinitely\n"));
# if defined(USE_TTY)
EPUTS(_(" --tty-control enable keyboard controls\n"));
EPUTS(_(" --no-tty-control disable keyboard controls\n"));
# endif
EPUTS(_("\nMiscellaneous:\n"));
EPUTS(_(" -T, --show-tags-only "
"show ID3/encoder tags only (do not decode)\n"));
EPUTS(_(" -V, --version display version number and exit\n"));
EPUTS(_(" --license "
"show copyright/license message and exit\n"));
EPUTS(_(" -h, --help display this help and exit\n"));
EPUTS(_("\nSupported output formats:\n"));
EPUTS(_(" cdda "
"CD audio, 16-bit big-endian 44100 Hz stereo PCM (*.cdr, *.cda)\n"));
EPUTS(_(" aiff Audio IFF, [16-bit] PCM (*.aif, *.aiff)\n"));
EPUTS(_(" wave Microsoft RIFF/WAVE, [16-bit] PCM (*.wav)\n"));
fprintf(stream,
_(" snd Sun/NeXT audio, 8-bit ISDN %s (*.au, *.snd)\n"),
_("mu-law"));
EPUTS(_(" raw binary [16-bit] host-endian linear PCM\n"));
EPUTS(_(" hex ASCII hexadecimal [24-bit] linear PCM\n"));
# if defined(HAVE_LIBESD)
EPUTS(_(" esd "
"Enlightened Sound Daemon [16-bit] (give speaker host as PATH)\n"));
# endif
# if defined(HAVE_LIBAUDIO)
EPUTS(_(" nas "
"Network Audio System [16-bit] (give server name as PATH)\n"));
# endif
EPUTS(_(" null no output (decode only)\n"));
}
