man page does not mention --sync / -S option but --help does

Open Be-ing opened this issue 4 years ago • 1 comments

Describe the bug

The man page for jackd says:

-S, --shorts Try to configure card for 16-bit samples first, only trying 32-bits if unsuccessful. (default: 32-bit samples)

But jackd --help says:

[ --sync OR -S ]

As far as I can tell the difference between synchronous mode and asynchronous mode is not really documented anywhere except buried in a wiki page comparing JACK1 and JACK2. This is IMO concerning because it adds extra latency in contradiction to the JACK website.

$ man jackd
$ jackd --help

man jackd should document the -S option and explain the tradeoffs of using it versus not using it.

Mar 21 '21 11:03 Be-ing

Several options are shared between different contexts depending on their order. The manpage lists all of them in one.

-S, --shorts is under the ALSA Backend options context not server

jackd -d alsa --help
-S, --shorts 	Try 16-bit samples before 32-bit (default: false)

FWIW sync != low latency, it means synchronous. Whether that results in lower latency or not is implementation dependent.

Dec 02 '21 11:12 h1z1