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=-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 4b1e589d for ; Fri, 16 Nov 2018 05:33:10 +0000 (UTC) Received: by minnie.tuhs.org (Postfix, from userid 112) id D3B95A26F1; Fri, 16 Nov 2018 15:33:09 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id CCDD1A26D5; Fri, 16 Nov 2018 15:32:45 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id 069ECA26D6; Fri, 16 Nov 2018 15:32:43 +1000 (AEST) Received: from viclamta06p.bpe.bigpond.com (viclamta06p.bpe.bigpond.com [203.38.21.70]) by minnie.tuhs.org (Postfix) with ESMTPS id 139B9A26D5 for ; Fri, 16 Nov 2018 15:32:41 +1000 (AEST) Received: from smtp.telstra.com ([10.10.26.4]) by viclafep06p-svc.bpe.nexus.telstra.com.au with ESMTP id <20181116053239.THJN4650.viclafep06p-svc.bpe.nexus.telstra.com.au@smtp.telstra.com> for ; Fri, 16 Nov 2018 16:32:39 +1100 X-RG-Spam: Unknown X-RazorGate-Vade-Verdict: clean 0 X-RazorGate-Vade-Classification: clean X-RazorGate-Vade: gggruggvucftvghtrhhoucdtuddrgedtkedrleeigdekiecutefuodetggdotefrodftvfcurfhrohhfihhlvgemucfupfevtfgpvffgnffuvfftteenuceurghilhhouhhtmecufedttdenucenucfjughrpeffhffvufgjkfhffgggtgesthdttddttdervdenucfhrhhomhepffgrvhgvucfjohhrshhfrghllhcuoegurghvvgeshhhorhhsfhgrlhhlrdhorhhgqeenucfkphepuddutddrudeguddrudelfedrvdeffeenucfrrghrrghmpehhvghloheprghnvghurhhinhdrhhhorhhsfhgrlhhlrdhorhhgpdhinhgvthepuddutddrudeguddrudelfedrvdeffedpmhgrihhlfhhrohhmpeeouggrvhgvsehhohhrshhfrghllhdrohhrgheqpdhrtghpthhtohepoehtuhhhshesthhuhhhsrdhorhhgqeenucevlhhushhtvghrufhiiigvpedt X-RG-VS-CLASS: clean Received: from aneurin.horsfall.org (110.141.193.233) by smtp.telstra.com (9.0.019.26-1) id 5BB3FBB607DB2E37 for tuhs@tuhs.org; Fri, 16 Nov 2018 16:32:39 +1100 Received: from aneurin.horsfall.org (localhost [127.0.0.1]) by aneurin.horsfall.org (8.15.2/8.15.2) with ESMTP id wAG5Wc6v072529 for ; Fri, 16 Nov 2018 16:32:38 +1100 (EST) (envelope-from dave@horsfall.org) Received: from localhost (dave@localhost) by aneurin.horsfall.org (8.15.2/8.15.2/Submit) with ESMTP id wAG5Wb7Z072526 for ; Fri, 16 Nov 2018 16:32:38 +1100 (EST) (envelope-from dave@horsfall.org) X-Authentication-Warning: aneurin.horsfall.org: dave owned process doing -bs Date: Fri, 16 Nov 2018 16:32:37 +1100 (EST) From: Dave Horsfall To: The Eunuchs Hysterical Society In-Reply-To: <20181116045016.GK3341@mcvoy.com> Message-ID: References: <201811160003.wAG03mlF139232@tahoe.cs.Dartmouth.EDU> <20181116045016.GK3341@mcvoy.com> User-Agent: Alpine 2.21.9999 (BSF 287 2018-06-16) X-GPG-Public-Key: http://www.horsfall.org/gpgkey.pub X-GPG-Fingerprint: 05B4 FFBC 0218 B438 66E0 587B EF46 7357 EF5E F58B X-Home-Page: http://www.horsfall.org/ X-Witty-Saying: "chmod 666 the_mode_of_the_beast" MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII; format=flowed 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: , Errors-To: tuhs-bounces@minnie.tuhs.org Sender: "TUHS" On Thu, 15 Nov 2018, Larry McVoy wrote: > How good is good enough: documentation > > Looking at Sun man pages versus Linux man pages is like looking at a Van > Gogh or Monet after studying the work of the high school football player > taking art as an "easy" elective. > > Amy Graf, BitMover The Unix manpage format is the epitome of perfection; they tell you everything you need to know, and in the right order. Frequently I cannot recall a particular flag (but I know what it does), and it's right there at the start. -- Dave