>Quite a few manual pages already have an examples section in them so
>the precedent is there already.

It has been pointed out already that IBM did *some* things right in AIX...
SMIT is not too bad, and their manual pages are nice. Each and everyone
contains at least some example... Forget about the programming man pages,
the examples there are too contrived to mention, but the general user and
sysadmin man pages are really helpful, without clogging the man pages with
junk.

                                -- Bert Driehuis

------
Bert Driehuis                 God, grant me the serenity to accept the things
driehuis@playbeing.org        I can't change, courage to change the things I
                              can, and the wisdom to know the difference.