Feature proposal: New, Standard Documentation System

[Camilo Mesias]

2008/12/1 Les Mikesell <lesmikesell at 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