From mboxrd@z Thu Jan  1 00:00:00 1970
Message-ID: <3edbb23041f9890eb0bce8a0b917b6c0@terzarima.net>
To: 9fans@cse.psu.edu
Subject: Re: [9fans] Capitalization in man pages.
From: Charles Forsyth <forsyth@terzarima.net>
Date: Tue,  6 Dec 2005 09:44:21 +0000
In-Reply-To: <7359f0490512052301j592031dft96b46e860da7198d@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="US-ASCII"
Content-Transfer-Encoding: 7bit
Topicbox-Message-UUID: b92485be-ead0-11e9-9d60-3106f5b1d025

following the rules of English text in manual pages
was followed reasonably consistently in later versions
of Unix, and in all the years i've worked with any
of the systems, i cannot recall an instance where i
was stumped, and certainly was never so perplexed that
i couldn't invoke the command or write the code
to call the function.   (the content of manual pages
in some other Unix-like systems is quite another matter,
but i refer only to Unix and its relatives.)

as with the `obfuscated X' contests (where X is a variable, but obviously
includes the window system), no doubt one can construct
a manual page that provokes a mixture of humour and head-scratching,
but that's art or artifice not documentation.