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 7159f5d6 for ; Mon, 19 Nov 2018 03:10:12 +0000 (UTC) Received: by minnie.tuhs.org (Postfix, from userid 112) id 887E2A1B16; Mon, 19 Nov 2018 13:10:11 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 66261A1AFD; Mon, 19 Nov 2018 13:09:54 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id 72ABDA1AFD; Mon, 19 Nov 2018 13:09:52 +1000 (AEST) Received: from mpv4-2015.case.edu (mpv4-2015.CWRU.Edu [129.22.103.195]) by minnie.tuhs.org (Postfix) with ESMTPS id B6606A1AFC for ; Mon, 19 Nov 2018 13:09:51 +1000 (AEST) Received: from mpv6-2015.CWRU.Edu (EHLO mpv6-2015.case.edu) ([129.22.103.202]) by mpv4-2015.case.edu (MOS 4.4.8-GA FastPath queued) with ESMTP id AUI52795; Sun, 18 Nov 2018 22:09:50 -0500 (EST) Received: from mail-qk1-f199.google.com (EHLO mail-qk1-f199.google.com) ([209.85.222.199]) by mpv6-2015.case.edu (MOS 4.4.8-GA FastPath queued) with ESMTP id CIV70647; Sun, 18 Nov 2018 22:09:50 -0500 (EST) Received: by mail-qk1-f199.google.com with SMTP id 98so66053324qkp.22 for ; Sun, 18 Nov 2018 19:09:50 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:reply-to:cc:subject:to:references:from:openpgp :autocrypt:organization:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=L3nO+snh4CfzPceBGziULLhz7TCRzc9FykSWsRLmQkM=; b=qGhE4GqQkGtgQJUy8hmVSfs68TVD+sUEN0YONAfDOZPNBhX4heiJD6RRGSEKThm3lV Qzx9R3yZC/xX9uVMwpMy+qtkrOiiRxwmzLv6qaJCcGGEWL3RLLApxe8620bZqkT9hd56 e3ZYtySlWvxphcjCwRYJWprnP7UVHasnTxn1lvPBPATSoADjsz2ISVnu4netJmLe2Sv3 I0ClBJorxmUo9pIYGrBKOJIChc3K9dBtZay+2QZnQaIpUrGuO/gUIqmj4sWZHDl2wKnC 3jkWVcgO2/MvL5/BoMEpJYE1/BYdsXl9ytGdUYn/UJo1ZVSPSVop790MfwZd48Uek4O+ 0xmA== X-Gm-Message-State: AGRZ1gLu4q/cEwysTQ/12hMZT3oTf8jTNhJr3XKv7BLLCN6GFcJuP97X Wwc1jz1R6LX59qjwVkd4zEBAslDXSQI6+xe4/+8Uq6VGKx666finwRo3X4H23QbiQdQzG7wvla7 NfLnXMy551QDUB1Uu X-Received: by 2002:ac8:1779:: with SMTP id u54mr19112590qtk.285.1542596989624; Sun, 18 Nov 2018 19:09:49 -0800 (PST) X-Google-Smtp-Source: AJdET5fzMYllp0okelZB+TEK7iI3ZAAO/gjEsJChkKfH+JKyTbsRwM/uglZpRr1hw9xAa9clkysthg== X-Received: by 2002:ac8:1779:: with SMTP id u54mr19112579qtk.285.1542596989390; Sun, 18 Nov 2018 19:09:49 -0800 (PST) Received: from jenna.local (h44.79.21.98.dynamic.ip.windstream.net. [98.21.79.44]) by smtp.gmail.com with ESMTPSA id f2sm9866412qkj.54.2018.11.18.19.09.48 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 18 Nov 2018 19:09:48 -0800 (PST) To: Toby Thain , tuhs@minnie.tuhs.org References: <26292231.693.1542401951390.JavaMail.root@zimbraanteil> <20181117233832.9E28A215C0@orac.inputplus.co.uk> <1684725999.70092.1542501071189.JavaMail.tomcat@india-live-be03> <15c4f386-85b0-3b5f-625c-e3bda1506d96@telegraphics.com.au> From: Chet Ramey Openpgp: preference=signencrypt Autocrypt: addr=chet.ramey@case.edu; prefer-encrypt=mutual; keydata= xsDiBEEOsGwRBACFa0A1oa71HSZLWxAx0svXzhOZNQZOzqHmSuGOG92jIpQpr8DpvgRh40Yp AwdcXb8QG1J5yGAKeevNE1zCFaA725vGSdHUyypHouV0xoWwukYO6qlyyX+2BZU+okBUqoWQ koWxiYaCSfzB2Ln7pmdys1fJhcgBKf3VjWCjd2XJTwCgoFJOwyBFJdugjfwjSoRSwDOIMf0D /iQKqlWhIO1LGpMrGX0il0/x4zj0NAcSwAk7LaPZbN4UPjn5pqGEHBlf1+xDDQCkAoZ/VqES GZragl4VqJfxBr29Ag0UDvNbUbXoxQsARdero1M8GiAIRc50hj7HXFoERwenbNDJL86GPLAQ OTGOCa4W2o29nFfFjQrsrrYHzVtyA/9oyKvTeEMJ7NA3VJdWcmn7gOu0FxEmSNhSoV1T4vP2 1Wf7f5niCCRKQLNyUy0wEApQi4tSysdz+AbgAc0b/bHYVzIf2uO2lIEZQNNt+3g2bmXgloWm W5fsm/di50Gm1l1Na63d3RZ00SeFQos6WEwLUHEB0yp6KXluXLLIZitEJM0aQ2hldCBSYW1l eSA8Y2hldEBjd3J1LmVkdT7CYQQTEQIAIQIbAwYLCQgHAwIDFQIDAxYCAQIeAQIXgAUCQ+La kQIZAQAKCRC7WGnwZOp0q9rGAJ4sRGLmlF8klZTH75z7jyQScpU6aACeNMahjWIhumt4u96d 9mdMJqlabVnOwE0EQQ6wbxAEAJCukwDigRDPhAuI+lf+6P64lWanIFOXIndqhvU13cDbQ/Wt 5LwPzm2QTvd7F+fcHOgZ8KOFScbDpjJaRqwIybMTcIN0B2pBLX/C10W1aY+cUrXZgXUGVISE MmpaP9v02auToo7XXVEHC+XLO9IU7/xaU98FL69l6/K4xeNSBRM/AAMHA/wNAmRBpcyK0+Vg gZ5esQaIP/LyolAm2qwcmrd3dZi+g24s7yjV0EUwvRP7xHRDQFgkAo6++QbuecU/J90lxrVn QwucZmfz9zgWDkT/MpfB/CNRSKLFjhYq2yHmHWT6vEjw9Ry/hF6Pc0oh1a62USdfaKAiim0n VxxQmPmiRvtCmcJJBBgRAgAJBQJBDrBvAhsMAAoJELtYafBk6nSr43AAn2ZZFQg8Gs/zUzvX Mt7evaFqVTzcAJ0cHtKpP1i/4H4R9+OsYeQdxxWxTQ== Organization: ITS, Case Western Reserve University Message-ID: Date: Sun, 18 Nov 2018 22:09:47 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 MIME-Version: 1.0 In-Reply-To: <15c4f386-85b0-3b5f-625c-e3bda1506d96@telegraphics.com.au> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit X-Junkmail-Status: score=10/90, host=mpv4-2015.case.edu X-Junkmail-PrAS-Raw: score=10/90, refid=2.7.2:2018.11.19.22417:17:10.202, ip=, rules=__YOUTUBE_RCVD, __X_GOOGLE_DKIM_SIGNATURE, __HAS_REPLYTO, __HAS_CC_HDR, __SUBJ_REPLY, __BOUNCE_CHALLENGE_SUBJ, __BOUNCE_NDR_SUBJ_EXEMPT, __SUBJ_ALPHA_END, __TO_MALFORMED_2, __TO_NAME, __TO_NAME_DIFF_FROM_ACC, __REFERENCES, __HAS_FROM, FROM_EDU_TLD, __HAS_MSGID, __SANE_MSGID, DATE_TZ_NA, __USER_AGENT, __MOZILLA_USER_AGENT, __MIME_VERSION, __IN_REP_TO, __CT, __CT_TEXT_PLAIN, __CTE, __REPLYTO_SAMEAS_FROM_ADDY, __REPLYTO_SAMEAS_FROM_ACC, __FROM_DOMAIN_IN_ANY_CC1, __FROM_DOMAIN_IN_ANY_CC2, __TO_IN_SUBJECT2, __REPLYTO_SAMEAS_FROM_DOMAIN, __ANY_URI, __URI_WITH_PATH, __URI_NO_WWW, __CP_URI_IN_BODY, __CP_NOT_1, __SUBJ_ALPHA_NEGATE, SUPERLONG_LINE, __URI_IN_BODY, __URI_NOT_IMG, __FORWARDED_MSG, __NO_HTML_TAG_RAW, BODY_SIZE_1500_1599, BODYTEXTP_SIZE_3000_LESS, __MIME_TEXT_P1, __MIME_TEXT_ONLY, __URI_NS, HTML_00_01, HTML_00_10, BODY_SIZE_5000_LESS, IN_REP_TO, [TRUNCATED], so=2010-03-03 19:42:08, dmn=2016-08-03-0138 X-Mirapoint-Virus-RAPID-Raw: score=unknown(0), refid=str=0001.0A020207.5BF2297F.000C,ss=1,re=0.000,fgs=0, ip=98.21.79.44, so=2016-11-06 16:00:04, dmn=2011-05-27 18:58:46 X-Mirapoint-Loop-Id: 52b7c8c87d436ec9bc61f2ecb590df01 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: chet.ramey@case.edu Errors-To: tuhs-bounces@minnie.tuhs.org Sender: "TUHS" On 11/17/18 10:00 PM, Toby Thain wrote: > On 2018-11-17 7:31 PM, Donald ODona wrote: >> >> >> At 17 Nov 2018 23:39:45 +0000 (+00:00) from Ralph Corderoy : >>> >>> From somewhere that didn't fit in well with Unix. >> its based on TekInfo, whereas 'Tek' allegedly refers to the anachronistic Tape Editor and Corrector, developed by a student (Dan Murphy) in 1964 on a PDP-1 without a operation system. According to the myth TekInfo was build on top of the Tape Editor, and finally made it on *NIX. >> >> 'Info' really doesn't fit in well with Unix. Its alien and another failed approach. Almost all 'GNU' man pages state, that the 'full' documentation is only available via 'info'. In real 99% of all 'info' requests result in 'info' processing a man page. > > > In many notable examples, that is not true: e.g. GNU make, bash or bison > come quickly to mind. You can't fully learn how to use tools like these > from the abbreviated man page; for one thing, the man page only mentions > a fraction of the features. The man page for bash includes everything. The info manual includes more examples. I think other authors should follow that model, but I'm not going to tell a volunteer what he has to do, and I understand how difficult it is to maintain parallel content. -- ``The lyf so short, the craft so long to lerne.'' - Chaucer ``Ars longa, vita brevis'' - Hippocrates Chet Ramey, UTech, CWRU chet@case.edu http://tiswww.cwru.edu/~chet/