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=DKIM_SIGNED,DKIM_VALID, MAILING_LIST_MULTI autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 32521 invoked from network); 31 Aug 2020 19:14:42 -0000 Received: from alyss.skarnet.org (95.142.172.232) by inbox.vuxu.org with ESMTPUTF8; 31 Aug 2020 19:14:42 -0000 Received: (qmail 32736 invoked by uid 89); 31 Aug 2020 19:15:02 -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 32726 invoked from network); 31 Aug 2020 19:15:02 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=imca-cat-org.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:content-transfer-encoding:in-reply-to; bh=o3o5/n0o+BuUU9pTIvDSZ3Ussfqjq/vNU5SVCYVHwQ0=; b=wgFYa/2AwV3x+uzaLoW4cTxWkHgeWH3GmiG3sv0SeUPX+AeaDwME2GfCNpme4cz+eh j0afE532G97id599vek0WofnqoWvPry1qEc3SFL+1q75pE4dgAnw7B2j6WMBOQLwHI4e 251Jht0bWeFmfM3i4yXB9loUBF54Yl97t16BGGwAWLoLSyouzXBYX5KzKWnBvrdSwdbj +uy5yvFmOjOvU/hxonghw4ogYg0NVE0AquhYKxw59Ot1P4gy3EpLGpHb0R9RGE5yAq/l 79mO9skBVRjlWETtXnbKb8X2HYZGavzTl2OxadK+LnHhFTrOnRg/pOHBiyVIT3GG1pgl vrkw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:content-transfer-encoding :in-reply-to; bh=o3o5/n0o+BuUU9pTIvDSZ3Ussfqjq/vNU5SVCYVHwQ0=; b=ragk3kBgHxif1sdhA9dgK7/pDpRausrX06Br+GIuN4hFO0aI3eH8zeqCw5spnwkmnZ /tIuDLfgRZUs+S3QbUTYHO6942lH92uSqdZiuXwHL9517MwTnlRaQ5vLWsiCJoJZf+bL O1jeX0Y/ohEfQvxoLw8s/znjt4jwiy6wnzdixJHbxLRsPvAv4zCs5WJ9QnAX8BHtPmns 1/gRT/5owaKQsXRUSiuC7Z6PbgEPA1NSTp7S5UhaVTnHaPox8sVokPu3AHd2YW5BD/+U S/0NkuzCamAfULfRRx2gSydLNWClqTm+GFZdbwOh/0evYni3O/NgxREjAp2e6zgN3TQu C6rw== X-Gm-Message-State: AOAM532OYiMyErJuNGygTRFyejR/CMnms2JQtcKntFgkDrLU07OdhSLV nFGeYYhNONYhattW3hPdW8WlzdoodblMHw== X-Google-Smtp-Source: ABdhPJzqanEGOqHpGPehBpaGnwX9wTFKjLDWx76LWSlLnpF9jEmiQ/X2yMpOA/p+Sz8sQvDfCoggmA== X-Received: by 2002:a92:1597:: with SMTP id 23mr2510624ilv.58.1598901274635; Mon, 31 Aug 2020 12:14:34 -0700 (PDT) Date: Mon, 31 Aug 2020 14:14:33 -0500 From: "J. Lewis Muir" To: Jason Lenz Cc: Laurent Bercot , supervision@list.skarnet.org Subject: Re: [request for review] Port of s6 documentation to mdoc(7) Message-ID: <20200831191433.wbjh6wltyqhdv5hl@mail.imca-cat.org> References: <877dtgtu1z.fsf@ada> <20200831160811.6zqdbyjyzk4bembt@mail.imca-cat.org> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: On 08/31, Jason Lenz wrote: > On 8/31/20 11:08 AM, J. Lewis Muir wrote: > > On 08/30, Laurent Bercot wrote: > > > > i've spent the last couple of weeks porting the s6 documentation to mdoc(7) format: > > > > > > > > https://github.com/flexibeast/s6-man-pages > > > Excellent, thank you. There is a lot of talk (especially on the #s6 > > > IRC channel, but occasionally on the mailing-list too) about people > > > wanting to have s6 man pages, but very rarely people wanting to actually > > > do the *work*. This is clearly the most advanced conversion ever > > > performed, well done! > > > > > I don't want to rain on anyone's parade, and I certainly would like to > > see s6 man pages, but it seems like such a waste of effort to maintain > > two sets of documentation. Laurent, isn't there a source format that > > you'd be OK with that could be used to generate mdoc? > > > > Have you considered docbook2mdoc? > > > > https://mandoc.bsd.lv/docbook2mdoc/ > > I'm just happy someone is creating manual pages, so I'm not going to "look a > gift horse in the mouth". ;-) Yes, and I certainly didn't intend to do that if you're suggesting that I have, and that's what I was trying to communicate when I said > > I don't want to rain on anyone's parade, and I certainly would like to > > see s6 man pages but at the same time, I thought I'd make one last plea, if you will, before too much time is invested since, like I said, it felt like such a waste. I mean, if there were a source format that everyone could be happy with, then Alexis could spend time on getting that working instead of spending time on something that will require indefinite maintenance. But if there is no such solution, and having two separately maintained sets of documentation is the only way to get man pages, then yes, I still would be very thankful for Alexis's work. > With that said I believe Laurent mentioned in the past that he considered a > suggestion from someone to use the scdoc utility (links below), as long as > someone else did the initial work to port to that format?  It's a simplified > markup format, so although much easier to read probably not as powerful as > mdoc. > > https://drewdevault.com/2018/05/13/scdoc.html > > https://git.sr.ht/~sircmpwn/scdoc I had forgotten about that; thanks for the reminder. I don't have any experience with scdoc either, but if Laurent is happy with it and it could serve as the source documentation format from which HTML and man pages could be generated, then it seems like a win to me. Lewis