2008/12/1 Les Mikesell <lesmikesell(a)gmail.com>:
Adding a few examples won't hurt, but man pages are not the place
for
conceptual fluff. We need some other format to hold an overview of why you
should use each program and how various program can be combined to
accomplish different results. Man pages should just contain a reference for
that program's use, because you won't look there until you already know why
you want to run it.
Don't forget you can have manpages for conceptual fluff (try man
selinux / which selinux), and you can find out what command you need
to do using 'apropos'. Example: apropos security
The man system really has been round the block a few times...
-Cam