Greg Wooledge wrote: > On Fri, Feb 01, 2019 at 06:06:18PM +0000, Joe wrote: > > On Fri, 1 Feb 2019 07:59:42 -0600 > > Richard Owlett <rowl...@cloud85.net> wrote: > > > > > ... a major deficiency of the man page format -- > > > [/begin_rant almost total lack of examples /end_rant ;] > > > > That's what's expected of man pages. If you want examples, poke around > > the Net for tutorials, and be prepared to find a wide range of quality. > > I disagree. Perhaps you've come to expect a lack of examples from the > man pages published by various GNU projects. GNU developers prefer their > own texinfo format instead, so they often write only stub man pages. > > A well-written man page includes an EXAMPLES section, unless the command > being documented is so trivial that none is required (e.g. true(1)).
... or the command is so complex that it refers you to other man pages: procmailex perlfaq and perlfaq1-9 -dsr-
