On Sat, Jun 22, 2019 at 11:05:00AM -0600, Theo de Raadt wrote: > I'm not happy with usage messages which fill half a screen. There has > to be some threshold where we include very little information, and force > people to the manual page instead. The many *ctl programs stradle this > threshold and while I understand the desire for a better usage message, > I think this is heading too far in the wrong direction. vmctl and ldomctl seem to be the only two control programs with such extensive usage; I appreciate this it does indeed helps me faster and more effectively than reading the manual.
gpioctl is on the same path with five lines, the rest of *ctl I glanced over either shows one (long) synopsis a la pfctl or uses an entirely different approach as seen with bgpctl. Neither of those make sense here I think. While I agree with you that a certain threshold of complexity requires reading the manual, but I do not think this go with limiting terse information in the usage.
