From mboxrd@z Thu Jan 1 00:00:00 1970 Mime-Version: 1.0 (Apple Message framework v746.2) In-Reply-To: <79ddb4f8ec11619fb01cef285299385c@terzarima.net> References: <79ddb4f8ec11619fb01cef285299385c@terzarima.net> Content-Type: text/plain; charset=US-ASCII; delsp=yes; format=flowed Message-Id: <43F57D70-3AA9-43A7-A3E0-2B80A7864722@orthanc.ca> Content-Transfer-Encoding: 7bit From: Lyndon Nerenberg Subject: Re: [9fans] Capitalization in man pages. Date: Tue, 6 Dec 2005 03:27:30 -0800 To: Fans of the OS Plan 9 from Bell Labs <9fans@cse.psu.edu> Topicbox-Message-UUID: b96a684a-ead0-11e9-9d60-3106f5b1d025 On Dec 6, 2005, at 3:17 AM, Charles Forsyth wrote: > Code??! well, there's a thought for us all. Writing code is easy. Writing the man page for it is the part that always gives me ulcers. And what pisses me off the most is that nobody else in the company even gives a f*** about the quality of the documentation. The number of times I've tried to explain the difference between a man page and a user manual, well ... I guess what bugs me about this whole topic is that the man pages I ship with my code are the visible representation of my work, therefore I put a lot of effort into writing something that *I* would want to read, as the end user. These days, nobody seems to understand why that's important ... --lyndon (frustrated writer?)