Re: [9fans] Capitalization in man pages.

[Lyndon Nerenberg <lyndon@orthanc.ca>]

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