From mboxrd@z Thu Jan 1 00:00:00 1970 Message-ID: Date: Wed, 7 Dec 2005 23:10:22 -0500 From: Russ Cox To: Fans of the OS Plan 9 from Bell Labs <9fans@cse.psu.edu> Subject: Re: [9fans] Capitalization in man pages. In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline References: <200512061430.aa89515@salmon.maths.tcd.ie> <91a834f68df7b1af7de479b2062c27d7@terzarima.net> <7359f0490512061031l37438297s18782869396d35e6@mail.gmail.com> Topicbox-Message-UUID: bec9fa44-ead0-11e9-9d60-3106f5b1d025 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