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 8bdaa2bb for ; Fri, 16 Nov 2018 18:39:59 +0000 (UTC) Received: by minnie.tuhs.org (Postfix, from userid 112) id ACBCCA2707; Sat, 17 Nov 2018 04:39:58 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 1C3C0A26D4; Sat, 17 Nov 2018 04:39:46 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id 362AEA26D4; Sat, 17 Nov 2018 04:39:44 +1000 (AEST) X-Greylist: delayed 3585 seconds by postgrey-1.35 at minnie.tuhs.org; Sat, 17 Nov 2018 04:39:43 AEST Received: from darkstar.fourwinds.com (fourwinds.com [63.64.179.162]) by minnie.tuhs.org (Postfix) with ESMTPS id ADDF293FC6 for ; Sat, 17 Nov 2018 04:39:43 +1000 (AEST) Received: from darkstar.fourwinds.com (localhost [127.0.0.1]) by darkstar.fourwinds.com (8.15.2/8.15.2) with ESMTP id wAGHdwql023006 for ; Fri, 16 Nov 2018 09:39:58 -0800 Received: from darkstar.fourwinds.com (jon@localhost) by darkstar.fourwinds.com (8.15.2/8.15.2/Submit) with ESMTP id wAGHdw3O023003 for ; Fri, 16 Nov 2018 09:39:58 -0800 Message-Id: <201811161739.wAGHdw3O023003@darkstar.fourwinds.com> From: Jon Steinhart To: tuhs@minnie.tuhs.org In-reply-to: <20181116171318.GC30000@mcvoy.com> References: <201811160003.wAG03mlF139232@tahoe.cs.Dartmouth.EDU> <20181116045016.GK3341@mcvoy.com> <7a632484-cdc7-7c59-7077-7a2c752045da@spamtrap.tnetconsulting.net> <20181116171318.GC30000@mcvoy.com> Comments: In-reply-to Larry McVoy message dated "Fri, 16 Nov 2018 09:13:18 -0800." MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <23001.1542389998.1@darkstar.fourwinds.com> Date: Fri, 16 Nov 2018 09:39:58 -0800 X-JON-SPAM: local delivery 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" Thanks Doug for accidentally starting this thread :-) I'm a big fan of the "original-style" man pages. Brevity was really important when working remote and having to look things up via a TI Silent 700 at 30 characters per second. I feel like the GNU project is responsible for destroying the usefulness of man pages with their "info" stuff. Nothing more helpful than getting a man page that says that it's not the man page and that one should look elsewhere using a different and very clunky program. Started the decline of being able to find everything in one place in a consistent manner. And just to rant, I really hate documentation that begins with how to get, build, and install software. I think that most folks looking at docs are wanting to know how to use it, and having to skip over the least-important stuff which is first is annoying, especially when one gets past it to discover that the rest of the doc was never written. Anyway, the sake of argument, I'm gonna postulate that the more recent, useless man pages are a sympton of poor software design. I'll make the claim that the loss of the "do one thing and do it well and make it composable" UNIX philosophy is exposed in many of the very complex utilities with huge numbers of dash options. Jon