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=-0.8 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, 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 dd7c1ec4 for ; Tue, 20 Nov 2018 07:17:49 +0000 (UTC) Received: by minnie.tuhs.org (Postfix, from userid 112) id DCDD494BB3; Tue, 20 Nov 2018 17:17:47 +1000 (AEST) Received: from minnie.tuhs.org (localhost [127.0.0.1]) by minnie.tuhs.org (Postfix) with ESMTP id 1CA66940FA; Tue, 20 Nov 2018 17:17:09 +1000 (AEST) Received: by minnie.tuhs.org (Postfix, from userid 112) id 040FE940FA; Tue, 20 Nov 2018 17:17:01 +1000 (AEST) X-Greylist: delayed 400 seconds by postgrey-1.35 at minnie.tuhs.org; Tue, 20 Nov 2018 17:16:54 AEST Received: from mini.drijf.net (mx2.drijf.net [80.101.204.214]) by minnie.tuhs.org (Postfix) with ESMTPS id 87A1C940F8 for ; Tue, 20 Nov 2018 17:16:54 +1000 (AEST) Received: from mini.drijf.net (localhost [127.0.0.1]) by mini.drijf.net (OpenSMTPD) with ESMTP id 3019f2ae; Tue, 20 Nov 2018 08:10:11 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=drijf.net; h=date:from:to :cc:subject:message-id:references:mime-version:content-type :in-reply-to; s=default; bh=kfPtW4k3mQcu1mKoXCGIGLLlqPk=; b=u76g 47I2GBqAOBXdJeB63zx4y8YYOXDqKcCcwK3DPOxESA58L4wb53XXPuBD1FiqxFs1 viGFQJSGqjjwSb6DqdAyR265b1Jrdt2KAmn2bmf8ree3lXZE5YjuDICdaUbFdYws mSAvZUNebK3QiuWMFS7H829V+SC58NbpYREI3mE= DomainKey-Signature: a=rsa-sha1; c=nofws; d=drijf.net; h=date:from:to:cc :subject:message-id:references:mime-version:content-type :in-reply-to; q=dns; s=default; b=bxtmCH3xAwxuHzlMsDzqtggYJxkmai Tu6mM235um6Cmr+S9PKmNowP9QkxNHhhIhpntZqv9OnSIpbV4gqAd6wmYFYdsIzt iohDD4mMNjFydeyCSiEAF7uefIH+sSZ1AshMoEwRD5nI5h17ixKNfbK7mOx3JYRG WAZDGaOdE9PKs= Received: from clue.drijf.net (clue.drijf.net [94.142.244.34]) by mx2.drijf.net (OpenSMTPD) with ESMTPSA id 3eb0f555 (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO); Tue, 20 Nov 2018 08:10:11 +0100 (CET) Date: Tue, 20 Nov 2018 08:10:09 +0100 From: Otto Moerbeek To: arnold@skeeve.com Message-ID: <20181120071009.GJ18762@clue.drijf.net> References: <4c36b2b2-76df-435f-27bc-e1feb0647f36@case.edu> <201811162113.wAGLDGiQ031455@darkstar.fourwinds.com> <201811190311.wAJ3BDHR028154@darkstar.fourwinds.com> <20181119173952.GA19377@thunk.org> <201811200652.wAK6qcV1020423@freefriends.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <201811200652.wAK6qcV1020423@freefriends.org> User-Agent: Mutt/1.10.1 (2018-07-13) 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" On Mon, Nov 19, 2018 at 11:52:38PM -0700, arnold@skeeve.com wrote: > 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 I'd like to mention mandoc. It takes mdoc or man pages and produces output in various formats. See e.g. http://man.openbsd.org/mandoc. The formatting and links are derived from the semantic info in the source pages.x -Otto