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?)
