Merge pull request #869 from JasonLG1979/clarify-arg-descriptions

Improve command line option description grammar
This commit is contained in:
Roderick van Domburg 2021-10-24 19:28:08 +02:00 committed by GitHub
commit f21c25a257
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -248,7 +248,7 @@ fn get_setup(args: &[String]) -> Setup {
).optopt(
"",
SYSTEM_CACHE,
"Path to a directory where system files (credentials, volume) will be cached. Can be different from cache option value.",
"Path to a directory where system files (credentials, volume) will be cached. May be different from the cache option value.",
"PATH",
).optopt(
"",
@ -257,7 +257,7 @@ fn get_setup(args: &[String]) -> Setup {
"SIZE"
).optflag("", DISABLE_AUDIO_CACHE, "Disable caching of the audio data.")
.optopt("n", NAME, "Device name.", "NAME")
.optopt("", DEVICE_TYPE, "Displayed device type.", "TYPE")
.optopt("", DEVICE_TYPE, "Displayed device type. Defaults to 'Speaker'.", "TYPE")
.optopt(
BITRATE,
"bitrate",
@ -270,14 +270,14 @@ fn get_setup(args: &[String]) -> Setup {
"Run PROGRAM when a playback event occurs.",
"PROGRAM",
)
.optflag("", EMIT_SINK_EVENTS, "Run program set by --onevent before sink is opened and after it is closed.")
.optflag("", EMIT_SINK_EVENTS, "Run PROGRAM set by --onevent before sink is opened and after it is closed.")
.optflag("v", VERBOSE, "Enable verbose output.")
.optflag("V", VERSION, "Display librespot version string.")
.optopt("u", USERNAME, "Username to sign in with.", "USERNAME")
.optopt("p", PASSWORD, "Password", "PASSWORD")
.optopt("u", USERNAME, "Username used to sign in with.", "USERNAME")
.optopt("p", PASSWORD, "Password used to sign in with.", "PASSWORD")
.optopt("", PROXY, "HTTP proxy to use when connecting.", "URL")
.optopt("", AP_PORT, "Connect to AP with specified port. If no AP with that port are present fallback AP will be used. Available ports are usually 80, 443 and 4070.", "PORT")
.optflag("", DISABLE_DISCOVERY, "Disable discovery mode.")
.optopt("", AP_PORT, "Connect to an AP with a specified port. If no AP with that port is present a fallback AP will be used. Available ports are usually 80, 443 and 4070.", "PORT")
.optflag("", DISABLE_DISCOVERY, "Disable zeroconf discovery mode.")
.optopt(
"",
BACKEND,
@ -287,7 +287,7 @@ fn get_setup(args: &[String]) -> Setup {
.optopt(
"",
DEVICE,
"Audio device to use. Use '?' to list options if using alsa, portaudio or rodio.",
"Audio device to use. Use '?' to list options if using alsa, portaudio or rodio. Defaults to the backend's default.",
"NAME",
)
.optopt(
@ -299,10 +299,10 @@ fn get_setup(args: &[String]) -> Setup {
.optopt(
"",
DITHER,
"Specify the dither algorithm to use - [none, gpdf, tpdf, tpdf_hp]. Defaults to 'tpdf' for formats S16, S24, S24_3 and 'none' for other formats.",
"Specify the dither algorithm to use {none|gpdf|tpdf|tpdf_hp}. Defaults to 'tpdf' for formats S16, S24, S24_3 and 'none' for other formats.",
"DITHER",
)
.optopt("m", MIXER_TYPE, "Mixer to use {alsa|softvol}.", "MIXER")
.optopt("m", MIXER_TYPE, "Mixer to use {alsa|softvol}. Defaults to softvol", "MIXER")
.optopt(
"",
"mixer-name", // deprecated
@ -312,7 +312,7 @@ fn get_setup(args: &[String]) -> Setup {
.optopt(
"",
ALSA_MIXER_CONTROL,
"Alsa mixer control, e.g. 'PCM' or 'Master'. Defaults to 'PCM'.",
"Alsa mixer control, e.g. 'PCM', 'Master' or similar. Defaults to 'PCM'.",
"NAME",
)
.optopt(
@ -348,13 +348,13 @@ fn get_setup(args: &[String]) -> Setup {
.optopt(
"",
ZEROCONF_PORT,
"The port the internal server advertised over zeroconf uses.",
"The port the internal server advertises over zeroconf.",
"PORT",
)
.optflag(
"",
ENABLE_VOLUME_NORMALISATION,
"Play all tracks at the same volume.",
"Play all tracks at approximately the same apparent volume.",
)
.optopt(
"",
@ -377,19 +377,19 @@ fn get_setup(args: &[String]) -> Setup {
.optopt(
"",
NORMALISATION_THRESHOLD,
"Threshold (dBFS) to prevent clipping. Defaults to -2.0.",
"Threshold (dBFS) at which the dynamic limiter engages to prevent clipping. Defaults to -2.0.",
"THRESHOLD",
)
.optopt(
"",
NORMALISATION_ATTACK,
"Attack time (ms) in which the dynamic limiter is reducing gain. Defaults to 5.",
"Attack time (ms) in which the dynamic limiter reduces gain. Defaults to 5.",
"TIME",
)
.optopt(
"",
NORMALISATION_RELEASE,
"Release or decay time (ms) in which the dynamic limiter is restoring gain. Defaults to 100.",
"Release or decay time (ms) in which the dynamic limiter restores gain. Defaults to 100.",
"TIME",
)
.optopt(
@ -401,7 +401,7 @@ fn get_setup(args: &[String]) -> Setup {
.optopt(
"",
VOLUME_CTRL,
"Volume control type {cubic|fixed|linear|log}. Defaults to log.",
"Volume control scale type {cubic|fixed|linear|log}. Defaults to log.",
"VOLUME_CTRL"
)
.optopt(
@ -423,7 +423,7 @@ fn get_setup(args: &[String]) -> Setup {
.optflag(
"",
PASSTHROUGH,
"Pass raw stream to output, only works for pipe and subprocess.",
"Pass a raw stream to the output. Only works with the pipe and subprocess backends.",
);
let matches = match opts.parse(&args[1..]) {