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 ec32b259
	for <ml@inbox.vuxu.org>;
	Fri, 16 Nov 2018 05:37:22 +0000 (UTC)
Received: by minnie.tuhs.org (Postfix, from userid 112)
	id 8BDA2A26EA; Fri, 16 Nov 2018 15:37:21 +1000 (AEST)
Received: from minnie.tuhs.org (localhost [127.0.0.1])
	by minnie.tuhs.org (Postfix) with ESMTP id 62159A26D5;
	Fri, 16 Nov 2018 15:36:57 +1000 (AEST)
Received: by minnie.tuhs.org (Postfix, from userid 112)
 id 8D398A26D5; Fri, 16 Nov 2018 15:36:54 +1000 (AEST)
X-Greylist: delayed 735 seconds by postgrey-1.35 at minnie.tuhs.org;
 Fri, 16 Nov 2018 15:36:52 AEST
Received: from h1.fbrelay.privateemail.com (h1.fbrelay.privateemail.com
 [131.153.2.42])
 by minnie.tuhs.org (Postfix) with ESMTPS id 111CAA26D4
 for <tuhs@tuhs.org>; Fri, 16 Nov 2018 15:36:52 +1000 (AEST)
Received: from MTA-10-3.privateemail.com (mta-10.privateemail.com
 [68.65.122.20])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (No client certificate requested)
 by h1.fbrelay.privateemail.com (Postfix) with ESMTPS id C711781602
 for <tuhs@tuhs.org>; Fri, 16 Nov 2018 00:24:35 -0500 (EST)
Received: from MTA-10.privateemail.com (localhost [127.0.0.1])
 by MTA-10.privateemail.com (Postfix) with ESMTP id 39E2D60041;
 Fri, 16 Nov 2018 00:24:34 -0500 (EST)
Received: from localhost (unknown [10.20.151.207])
 by MTA-10.privateemail.com (Postfix) with ESMTPA id 3306660038;
 Fri, 16 Nov 2018 05:24:33 +0000 (UTC)
Date: Thu, 15 Nov 2018 21:24:30 -0800
From: Anthony Martin <ality@pbrane.org>
To: Doug McIlroy <doug@cs.dartmouth.edu>
Message-ID: <20181116052314.GA26474@alice>
References: <201811160003.wAG03mlF139232@tahoe.cs.Dartmouth.EDU>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <201811160003.wAG03mlF139232@tahoe.cs.Dartmouth.EDU>
X-Virus-Scanned: ClamAV using ClamSMTP
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: tuhs@tuhs.org
Errors-To: tuhs-bounces@minnie.tuhs.org
Sender: "TUHS" <tuhs-bounces@minnie.tuhs.org>

Doug McIlroy <doug@cs.dartmouth.edu> once said:
> For nagging reasons of verbal continuity, the options displays
> were prefaced by *needless words* like, "The following options
> are recognized". A simple OPTIONS heading would be better.

There's a good one in ls(1) from v8: "There are an unbelievable
number of options".

  Anthony