How are you supposed to write reference documentation without a section for describing the options which can be referred to by option name?
> The examples should have come first, in the synopsis.
Type with me: / E X A <return>. If anything, perhaps the first manual a man user should read is the manual for their default pager, usually LESS(1).
There are good and bad manpages, but I don't see how the format is truly deficient. Some very complex commands have separate sections for the most and least common options (or groups of related options, if there are subcommands or similar).
How are you supposed to write reference documentation without a section for describing the options which can be referred to by option name?
> The examples should have come first, in the synopsis.
Type with me: / E X A <return>. If anything, perhaps the first manual a man user should read is the manual for their default pager, usually LESS(1).
There are good and bad manpages, but I don't see how the format is truly deficient. Some very complex commands have separate sections for the most and least common options (or groups of related options, if there are subcommands or similar).