From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from omta002.cacentral1.a.cloudfilter.net (omta002.cacentral1.a.cloudfilter.net [3.97.99.33]) by sourceware.org (Postfix) with ESMTPS id 8990F3857C65 for ; Thu, 30 Sep 2021 16:06:10 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 8990F3857C65 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=SystematicSw.ab.ca Authentication-Results: sourceware.org; spf=none smtp.mailfrom=systematicsw.ab.ca Received: from shw-obgw-4004a.ext.cloudfilter.net ([10.228.9.227]) by cmsmtp with ESMTP id VspumP8rlps7PVyZWmGScL; Thu, 30 Sep 2021 16:06:10 +0000 Received: from [192.168.1.105] ([68.147.0.90]) by cmsmtp with ESMTP id VyZVmRi1AdCHGVyZVmOdrE; Thu, 30 Sep 2021 16:06:10 +0000 X-Authority-Analysis: v=2.4 cv=SdyUytdu c=1 sm=1 tr=0 ts=6155e072 a=T+ovY1NZ+FAi/xYICV7Bgg==:117 a=T+ovY1NZ+FAi/xYICV7Bgg==:17 a=IkcTkHD0fZMA:10 a=GcyzOjIWAAAA:8 a=AVA7Npw0kJt7WT1SnvIA:9 a=QEXdDO2ut3YA:10 a=hQL3dl6oAZ8NdCsdz28n:22 Reply-To: cygwin-apps@cygwin.com To: cygwin-apps@cygwin.com References: <2bae97c6-53da-3c28-5859-cdf75fadb0ce@dronecode.org.uk> From: Brian Inglis Organization: Systematic Software Subject: Re: [ITP] man-pages-linux Message-ID: <210fe691-1a02-d487-fc77-8d008216b4b6@SystematicSw.ab.ca> Date: Thu, 30 Sep 2021 10:06:09 -0600 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.14.0 MIME-Version: 1.0 In-Reply-To: <2bae97c6-53da-3c28-5859-cdf75fadb0ce@dronecode.org.uk> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-CA Content-Transfer-Encoding: 8bit X-CMAE-Envelope: MS4xfD+ETaioNVzjelF3EmJTz8shImswWK2NRot2LQ/oJ3HcbjF/lbY1pcCJYFcjfD8LfRUxO4Dpxq6wHg7j2Js3DBQOWHAL8/VQJiEd5klsE0oXhO+e8q5M A5McZpTcbuOFjdnHrQzWdnX+maFu0ClLzVv5bdPFYJSLEnfrvxNhsKdGdUqKkO011JT1ijZSZHIMqh9uAOJC/aUXrA3jDDl/seM= X-Spam-Status: No, score=-1159.9 required=5.0 tests=BAYES_00, BODY_8BITS, KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, KAM_SHORT, NICE_REPLY_A, RCVD_IN_BARRACUDACENTRAL, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=no autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: cygwin-apps@cygwin.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Cygwin package maintainer discussion list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Sep 2021 16:06:12 -0000 On 2021-09-30 08:38, Jon Turney wrote: > On 28/09/2021 00:04, Brian Inglis wrote: >> I would like to provide Cygwin packages for the Linux kernel man pages >> project, for those who are concerned about interoperability and >> portability, from Michael Kerrisk (http://man7.org/), who also >> releases man-pages-posix, and recently released Linux man-pages 5.13. >> >> I do it for my own use anyway, to have the latest docs, just to save >> flipping to Linux from Cygwin or Windows. >> >> The install location is under the standard /usr/share/man/linux/ which >> can only by default be used by specifying >> >>      $ man -m|--systems linux ... >> >> but can also be added explicitly to a users' MANPATH or alias e.g. >> >>      $ alias man='man -m man,linux' >> >> or swap the order to prioritize Linux, or for parallel installs add >> each in your preferred order. > > This is great.  Go ahead. > > I wonder if there's any scope for putting these pages in section > suffixed L or something e.g. 3L etc., so that pages could be found by > default for things which only exist on linux? > > (But possibly that also requires some adjustment to the man configuration?) That would require idempotent editing of /etc/man_db.conf to add sections 1l-8l in non-inappropriate places and deciding where they should go: $ grep '[0-9]p' /etc/man_db.conf SECTION 1 1p 8 2 3 3p 4 5 6 7 9 0p n $ sed -i -e '/^SECTION\s.*\sn$/s!$! 1l 8l 2l 3l 4l 5l 6l 7l!' \ /etc/man_db.conf I would prefer to use 1L-8L to be visibly different despite fonts and that also looks nasty! > Then I guess it would also be nice if a prologue similar to that of the > POSIX man pages (saying "this is the linux manpage, the cygwin > implementation may differ of be absent", could be added) Those pages already have a .SH PROLOG mentioning *Linux* which we just mass `sed -i` to *Cygwin*. We would have to insert the whole Cygwin prolog section before the first section. We could also have appended to .SH COLOPHON but not all pages have them. Those pages are already well labelled as Linux ... Manual, most with system Linux (some GNUtilities) with Linux caveats and mentions in many. Testing multi-system man configs, I have found keeping them in separate trees allows and forces me to prioritize whether I prefer defacto standard Linux next, the BSDs we frequently borrow from, and in which order, or Fedora on which we base some other stuff. I also add other distros, and my own local system cat1/cat8 pages from Windows and other utilities, so `man -awW ...` is my friend! ;^> -- Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada This email may be disturbing to some readers as it contains too much technical detail. Reader discretion is advised. [Data in binary units and prefixes, physical quantities in SI.]