[TUHS] man-page style
Bakul Shah
bakul at bitblocks.com
Fri Nov 16 13:50:26 AEST 2018
I have to write and rewrite to try to make things clear and concise.
Certainly worth doing but for some of us it takes a lot more typing
and thinking!
> On Nov 15, 2018, at 7:38 PM, Ken Thompson via TUHS <tuhs at minnie.tuhs.org> wrote:
>
> and it takes a lot less typing.
>
>
> On Thu, Nov 15, 2018 at 7:18 PM, Rob Pike <robpike at gmail.com> wrote:
>> As someone whose résumé, the one that got me in the door at Bell Labs, was
>> formatted with nroff -man, I of course support the clarity and precision
>> Doug celebrates. I wish the rest of the world agreed, but it doesn't.
>> Although I hold the editor line for much of the documentation for Go, for
>> instance, I fend off frequent requests to rewrite and expand. Flab is felt
>> to be friendlier, much as I (and Doug, who taught me more about writing than
>> anyone else) would prefer the leaner cuts.
>>
>> -rob
>>
More information about the TUHS
mailing list