From mboxrd@z Thu Jan 1 00:00:00 1970 Mime-Version: 1.0 (Apple Message framework v746.2) In-Reply-To: <7359f0490512052301j592031dft96b46e860da7198d@mail.gmail.com> References: <7359f0490512051714m21e8b7ffrd1e60bab69d8edc4@mail.gmail.com> <8FBB88DB-680F-4180-ACCD-DD0E29626B99@orthanc.ca> <7359f0490512052301j592031dft96b46e860da7198d@mail.gmail.com> Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed Message-Id: <4E5DF87E-174C-4B40-A158-940B339BD3B1@orthanc.ca> Content-Transfer-Encoding: 7bit From: Lyndon Nerenberg Subject: Re: [9fans] Capitalization in man pages. Date: Tue, 6 Dec 2005 03:12:37 -0800 To: Fans of the OS Plan 9 from Bell Labs <9fans@cse.psu.edu> Topicbox-Message-UUID: b955ace8-ead0-11e9-9d60-3106f5b1d025 On Dec 5, 2005, at 11:01 PM, Rob Pike wrote: > To avoid the confusion that can be introduced > by capitalizing a magic word, where possible I rewrote the > sentence to avoid the problem. With the nice side effect of making the pages more readable in general. Maintaining a balance between tech-geek and understandable descriptions of functionality in man pages is an art. There aren't many people who can do it, let alone do it well. It's a dilemma Shakespeare would have appreciated, I think. (Oh lord, do I see a Monty Python skit looming?) --lyndon