Re: [9fans] Capitalization in man pages.

[Russ Cox <rsc@swtch.com>]

Please don't rewrite all the man pages unless you
first establish the value in doing so.  Converting from
one troff macro package to another does not on first
glance seem to offer any benefit at all.  In fact, things
like man2html would then have to be updated, and
no doubt all the errors introduced would have to be
tracked down, and so on.  It hardly seems worth it,
especially considering that the outward appearance
would remain the same.

On the other hand, checking that the man pages reflect
reality (command line arguments, function signatures,
and so on) would be genuinely useful.  I encouraged some
others to do this a few years ago and they formed a group
called the Plan 9 Documentation Task Force and fixed a
few man pages but then I think they lost interest.

I made a bunch of updates to the plan9port man pages
when I did the "first fully documented release" a year ago.
Diffing those against the Plan 9 ones would be a good start.

Russ