Klemens Nanni <[email protected]> wrote: > On Sat, Jun 22, 2019 at 07:00:53PM +0200, Mark Kettenis wrote: > > Not sure such a long list is actually useful, but sure. > I'd argue it is complete and consistent. Both `man -h ldomctl' and > `ldomctl [-h]' would lack information, so there was no way of getting > a quick overview without reading the entire manual.
Sure there is a quick overview! Obviously, the existing usage hints that things are complicated, and a manu page consultation is required. Many many commands have incomplete usage, thereby leading you to the manual page. On the other hand, spamming 1/4 of a screen during incorrect usage risks damaging the user's understanding of context. I can give a few crazy examples: ld, cc, ksh. I'll say again, there surely are cases where it is pointless making usage be complete, because the compleness can be harmful. Is this one? Maybe...
