On Monday 07 November 2016, Karel Zak wrote: > On Mon, Nov 07, 2016 at 11:21:55AM +0100, Ruediger Meier wrote: > > BTW would be also very nice to ensure by design that --help, > > manpage and the actual commands are always synchron. > > It depends what do you mean with synchron. All options should be > documented by --help and man page, [...] Yes it should, but we have very often inconsistencies, like 89de71b3 3fabc363 21c6bcbd ce969b16 Bugs like these are IMO waste of human life time. They can be avoided automatically from the beginning. > For --help we want really minimalistic and easy to > translate description. The man page is unlimited area for creative > writers :-) It's not a big problem to add manually written text to the autogenerated one. Even help2man has such interface (--include and --opt-include). > Frankly, all we need is to detect mistakes (undocumented options). Why would you want to detect this but not want to use existing tools? > I'd like to be conservative and avoid complex solutions. I think our > --help is nice and works as expected :-) Even I've just run a stupid shell command line to find out that our getopt and flock have broken --help implementations. They print to stderr or do not return 0. I'm sure that we would find much more problems with the non-trivial options. whereis has no such options --help/--version. Is this on purpose? cu, Rudi -- To unsubscribe from this list: send the line "unsubscribe util-linux" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
