From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <tuhs-bounces@minnie.tuhs.org>
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on inbox.vuxu.org
X-Spam-Level: 
X-Spam-Status: No, score=-1.0 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS,
	MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE autolearn=ham autolearn_force=no
	version=3.4.2
Received: from minnie.tuhs.org (minnie.tuhs.org [45.79.103.53])
	by inbox.vuxu.org (OpenSMTPD) with ESMTP id 16599a31
	for <ml@inbox.vuxu.org>;
	Fri, 16 Nov 2018 03:51:13 +0000 (UTC)
Received: by minnie.tuhs.org (Postfix, from userid 112)
	id 7C7CFA26E9; Fri, 16 Nov 2018 13:51:12 +1000 (AEST)
Received: from minnie.tuhs.org (localhost [127.0.0.1])
	by minnie.tuhs.org (Postfix) with ESMTP id 3650DA26D5;
	Fri, 16 Nov 2018 13:50:58 +1000 (AEST)
Received: by minnie.tuhs.org (Postfix, from userid 112)
 id 201D0A26D5; Fri, 16 Nov 2018 13:50:56 +1000 (AEST)
Received: from mail.bitblocks.com (ns1.bitblocks.com [173.228.5.8])
 by minnie.tuhs.org (Postfix) with ESMTP id D2A8FA26D4
 for <tuhs@tuhs.org>; Fri, 16 Nov 2018 13:50:55 +1000 (AEST)
Received: from mob.bitblocks.com (mob.bitblocks.com [192.168.125.11])
 by mail.bitblocks.com (Postfix) with ESMTP id 3B36C156E40C;
 Thu, 15 Nov 2018 19:50:27 -0800 (PST)
Content-Type: text/plain;
	charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 12.1 \(3445.101.1\))
From: Bakul Shah <bakul@bitblocks.com>
In-Reply-To: <CAG=a+rgx4GF4Z+bwyKTTzr2UtBArisLgzdp_6JeP7d8q_Zy_pQ@mail.gmail.com>
Date: Thu, 15 Nov 2018 19:50:26 -0800
Content-Transfer-Encoding: quoted-printable
Message-Id: <63E23F12-DD93-410D-BFD7-621A25C5FF80@bitblocks.com>
References: <201811160143.wAG1hqbV019990@tahoe.cs.Dartmouth.EDU>
 <CAKzdPgxQPuBdBq6_4WNNOx--fpeV+iGc5bDww5+agWKBXd7A8Q@mail.gmail.com>
 <CAG=a+rgx4GF4Z+bwyKTTzr2UtBArisLgzdp_6JeP7d8q_Zy_pQ@mail.gmail.com>
To: Ken Thompson <ken@google.com>
X-Mailer: Apple Mail (2.3445.101.1)
Subject: Re: [TUHS] man-page style
X-BeenThere: tuhs@minnie.tuhs.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: The Unix Heritage Society mailing list <tuhs.minnie.tuhs.org>
List-Unsubscribe: <https://minnie.tuhs.org/cgi-bin/mailman/options/tuhs>,
 <mailto:tuhs-request@minnie.tuhs.org?subject=unsubscribe>
List-Archive: <http://minnie.tuhs.org/pipermail/tuhs/>
List-Post: <mailto:tuhs@minnie.tuhs.org>
List-Help: <mailto:tuhs-request@minnie.tuhs.org?subject=help>
List-Subscribe: <https://minnie.tuhs.org/cgi-bin/mailman/listinfo/tuhs>,
 <mailto:tuhs-request@minnie.tuhs.org?subject=subscribe>
Cc: The Eunuchs Hysterical Society <tuhs@tuhs.org>,
 Doug McIlroy <doug@cs.dartmouth.edu>
Errors-To: tuhs-bounces@minnie.tuhs.org
Sender: "TUHS" <tuhs-bounces@minnie.tuhs.org>

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@minnie.tuhs.org> wrote:
>=20
> and it takes a lot less typing.
>=20
>=20
> On Thu, Nov 15, 2018 at 7:18 PM, Rob Pike <robpike@gmail.com> wrote:
>> As someone whose r=C3=A9sum=C3=A9, 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.
>>=20
>> -rob
>>=20