From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 14721 invoked from network); 31 Aug 2020 11:04:07 -0000 Received: from alyss.skarnet.org (95.142.172.232) by inbox.vuxu.org with ESMTPUTF8; 31 Aug 2020 11:04:07 -0000 Received: (qmail 26130 invoked by uid 89); 31 Aug 2020 11:04:30 -0000 Mailing-List: contact supervision-help@list.skarnet.org; run by ezmlm Sender: Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Received: (qmail 26123 invoked from network); 31 Aug 2020 11:04:30 -0000 From: "Laurent Bercot" To: supervision@list.skarnet.org Subject: Re: [request for review] Port of s6 documentation to mdoc(7) Date: Mon, 31 Aug 2020 11:04:04 +0000 Message-Id: In-Reply-To: <87r1rns3ht.fsf@ada> References: <877dtgtu1z.fsf@ada> <87r1rns3ht.fsf@ada> Reply-To: "Laurent Bercot" User-Agent: eM_Client/8.0.3385.0 Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable X-VR-SPAMSTATE: OK X-VR-SPAMSCORE: 0 X-VR-SPAMCAUSE: gggruggvucftvghtrhhoucdtuddrgeduiedrudefhedgfeefucetufdoteggodftvfcurfhrohhfihhlvgemucfpfgfogfftkfevteeunffgpdfqfgfvnecuuegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkfgjfhhrfgggtgfgsehtqhertddtreejnecuhfhrohhmpedfnfgruhhrvghnthcuuegvrhgtohhtfdcuoehskhgrqdhsuhhpvghrvhhishhiohhnsehskhgrrhhnvghtrdhorhhgqeenucggtffrrghtthgvrhhnpeehvdfhheevieegueeuhfdthedvjeevkedvveffieeftdeufeeulefhtdejvddtueenucffohhmrghinhepfihikhhiphgvughirgdrohhrghenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhhouggvpehsmhhtphhouhht >Certainly. i'll do that once i've completed a linting pass. Excellent. >Sure, i'd be happy to reflect any changes. And the people rejoiced and celebrated, because they would soon, finally, have s6 man pages. >Ah, okay - thanks for the heads-up. Also a heads-up for people who are currently using s6-rc, including in elaborate distribution-integrated setups: don't worry, no matter how things shape up, the current version of s6-rc is going to be supported for a looooong time. >Now that i think about it some more, maybe i could simply put the link in= parentheses? For example, with: > > a CDB file cdbfile then exits 0. > >where "CDB file" is a link to the relevant Wikipedia page, the mdoc would= produce output like: > > a CDB file (http://en.wikipedia.org/wiki/Cdb_(software)) cdbfile th= en exits 0. I think that solely depends on the number of such links. If there are just a few, it's fine. If there are a lot of links in a page, it would make reading pretty unwieldy. Because I think there are a few pages with too many links, maybe it would be best, for consistency, to just use footnotes? < a CDB file[1] cdbfile then exits 0. < < (...) < < SEE ALSO < < [1]: http://en.wikipedia.org/wiki/Cdb_(software) Maybe mdoc even has a mechanism for footnotes? I don't know. >*nod* i'll try to put together an email with the relevant information, and = start hanging out on #s6. :-) i'm usually on Freenode, in #voidlinux in p= articular, but not necessarily active at the same time as others - i'm in M= elbourne.au. We don't care much about timezones. You can find people to interact=20 with at almost any time of the day, and if not, we generally answer as soon=20 as we're online. ;) -- Laurent