From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.8 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,HTML_FONT_LOW_CONTRAST,HTML_MESSAGE, 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 3e8df7b7 for ; Mon, 19 Nov 2018 15:50:28 +0000 (UTC) Received: by minnie.tuhs.org (Postfix, from userid 112) id 4B6C7A1B20; Tue, 20 Nov 2018 01:50:27 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 13EADA1AFF; Tue, 20 Nov 2018 01:50:06 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id 11128A1AFD; Tue, 20 Nov 2018 01:50:00 +1000 (AEST) X-Greylist: delayed 503 seconds by postgrey-1.35 at minnie.tuhs.org; Tue, 20 Nov 2018 01:49:54 AEST Received: from a1i299.smtp2go.com (a1i299.smtp2go.com [43.228.185.43]) by minnie.tuhs.org (Postfix) with ESMTPS id 46624A1AFC for ; Tue, 20 Nov 2018 01:49:54 +1000 (AEST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=smtpservice.net; s=m33y30.a1-4.dyn; x=1542643494; h=Feedback-ID: X-Smtpcorp-Track:To:Message-Id:Reply-To:Date:From:Subject:Sender: List-Unsubscribe; bh=d0RY7LZWaiDmUKAPM28wrJXOhh+wx+/NHdwVQXHxaOQ=; b=q4mblLMc Ex1nQ51RSoJXxTVHUolKBuoDsiDRrhYTipcdpWgw8V0AwJcPAWqkh98LD7qz3qg30ixO8BL04G2mT ZUmM6cRb3PIdKfaddZ72t/lus0BJggJ3pCbB8lbbtk29WU+gVEOvc/ZPOl5s/MShQFpUrZauNcSgY 3aa4UhmCKQHMu9NW1XntqWdRkNgduYW0cEGD5zbqgSoN2Szk4ojwX0OceNOGpPZV0FWSdhjdWZSC1 nW7CFnJrWrdOdonD2xMbg17MkUGW23wWew2GBJOFd5J8ceR5CPfZOBbakM9wJFt5WOFTAh4QJ+jkT JrDyeSokeX+wujKftO64y6vGPw==; Received: from [10.173.255.233] (helo=SmtpCorp) by smtpcorp.com with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.91) (envelope-from ) id 1gOlfy-Itk9Yk-SE; Mon, 19 Nov 2018 15:41:26 +0000 Received: from [10.107.193.50] (helo=kdbarto.org) by smtpcorp.com with esmtpsa (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.91) (envelope-from ) id 1gOlfy-IbZvgF-5Y; Mon, 19 Nov 2018 15:41:26 +0000 Received: from [192.168.2.10] (unknown [192.168.2.10]) by kdbarto.org (Postfix) with ESMTPS id 9E82812E59B4; Mon, 19 Nov 2018 07:41:23 -0800 (PST) Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) Content-Type: multipart/alternative; boundary="Apple-Mail=_3CD456F5-D100-4348-B7E7-7431E4537170" From: David In-Reply-To: Date: Mon, 19 Nov 2018 07:41:23 -0800 Message-Id: <7171EAB7-9557-4822-8FCE-5C7B1AD19B06@kdbarto.org> References: <201811160003.wAG03mlF139232@tahoe.cs.Dartmouth.EDU> <20181116045016.GK3341@mcvoy.com> <7a632484-cdc7-7c59-7077-7a2c752045da@spamtrap.tnetconsulting.net> <4c36b2b2-76df-435f-27bc-e1feb0647f36@case.edu> <201811162113.wAGLDGiQ031455@darkstar.fourwinds.com> <201811190311.wAJ3BDHR028154@darkstar.fourwinds.com> To: Clem Cole X-Mailer: Apple Mail (2.3124) X-Smtpcorp-Track: 1gO_fymPZvgF5Y.8IX_k3jtS Feedback-ID: 145083m:145083a-yaNWS:145083srkES2A7Wz X-Report-Abuse: Please forward a copy of this message, including all headers, to 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: david@kdbarto.org Cc: The Eunuchs Hysterical Society Errors-To: tuhs-bounces@minnie.tuhs.org Sender: "TUHS" --Apple-Mail=_3CD456F5-D100-4348-B7E7-7431E4537170 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 > On Nov 19, 2018, at 7:35 AM, Clem Cole wrote: >=20 >=20 >=20 > On Sun, Nov 18, 2018 at 10:11 PM Jon Steinhart > wrote: > Sort of like Americans expecting others to speak to them in English = when they travel instead of understanding that they're in a different = environment and it makes more sense to learn the culture as it's = unlikely that everybody is gonna change just for you. > Amen, brother Jon, can we get another Amen.. >=20 As a recent traveller overseas, Amen to that. >=20 > What started this whole thread was Doug's comment about how succinct = and to the point man was. If was a fine interface for >>UNIX<<. Man = (using roff) was what people expect. It's not about better or worse -- = it worked and worked well. >=20 >=20 > Clem > =E1=90=A7 > =E1=90=A7 The problem, as we have all converged on, is that writing well is hard. = Writing concise, targeted prose, is even harder. So we get bloat in man = pages or the info system which is just (IMHO) more bloat because people = don=E2=80=99t want to spend the time writing well. David --Apple-Mail=_3CD456F5-D100-4348-B7E7-7431E4537170 Content-Transfer-Encoding: quoted-printable Content-Type: text/html; charset=utf-8
On Nov 19, 2018, at 7:35 AM, Clem Cole <clemc@ccc.com> = wrote:



On = Sun, Nov 18, 2018 at 10:11 PM Jon Steinhart <jon@fourwinds.com> wrote:
Sort of like Americans = expecting others to speak to = them in English when they travel instead of understanding that = they're in a different environment and it makes more sense to = learn the culture as it's = unlikely that everybody is gonna change just for you.
Amen, brother Jon, can = we get another Amen..

As a recent traveller = overseas, Amen to that.


What started this whole = thread was Doug's comment about how succinct and  to the point man = was.  If was a fine interface for >>UNIX<<.  =  Man (using roff) was what people expect.  It's not about = better or worse -- it worked and worked well.


Clem
3D""=E1=90=A7
3D""=E1=90=A7<= /div>

The problem, as = we have all converged on, is that writing well is hard. Writing concise, = targeted prose, is even harder. So we get bloat in man pages or the info = system which is just (IMHO) more bloat because people don=E2=80=99t want = to spend the time writing well.

David

= --Apple-Mail=_3CD456F5-D100-4348-B7E7-7431E4537170--