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=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 2486dab7 for ; Tue, 20 Nov 2018 06:53:16 +0000 (UTC) Received: by minnie.tuhs.org (Postfix, from userid 112) id 4F6AC949B7; Tue, 20 Nov 2018 16:53:15 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 51C3D940FA; Tue, 20 Nov 2018 16:52:46 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id F200A940FA; Tue, 20 Nov 2018 16:52:43 +1000 (AEST) Received: from freefriends.org (freefriends.org [96.88.95.60]) by minnie.tuhs.org (Postfix) with ESMTP id 80713940F8 for ; Tue, 20 Nov 2018 16:52:43 +1000 (AEST) X-Envelope-From: arnold@skeeve.com Received: from freefriends.org (localhost [127.0.0.1]) by freefriends.org (8.14.9/8.14.9) with ESMTP id wAK6qcaw020424; Mon, 19 Nov 2018 23:52:39 -0700 Received: (from arnold@localhost) by freefriends.org (8.14.9/8.14.9/submit) id wAK6qcV1020423; Tue, 20 Nov 2018 06:52:38 GMT From: arnold@skeeve.com Message-Id: <201811200652.wAK6qcV1020423@freefriends.org> X-Authentication-Warning: frenzy.freefriends.org: arnold set sender to arnold@skeeve.com using -f Date: Mon, 19 Nov 2018 23:52:38 -0700 To: tytso@mit.edu, clemc@ccc.com References: <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> <20181119173952.GA19377@thunk.org> In-Reply-To: User-Agent: Heirloom mailx 12.4 7/29/08 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit 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: , Cc: tuhs@tuhs.org Errors-To: tuhs-bounces@minnie.tuhs.org Sender: "TUHS" Clem Cole wrote: > I think that's somewhat backwards in he spirit of 'UNIX'... the man and > info pages should reference the manual in /usr/doc/foo/ The goal for Info was to *be* the equivalent of /usr/doc/foo. Along the way the default for Info changed to go to the 'invoking' section of a manual so that you saw the options, arguably the most immediately useful part of a man page, attempting to give the user the best of both worlds. All that said, I think this topic has been beaten to death. Info did not successfully replace man pages. As a file format, I think that Info has very little left to offer. What I do *love* is the Texinfo markup language, which is wonderful for producing book-style documents. And what's nice is that a single input file can produce PDF, HTML and DocBook (as well as Info). Arnold