Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread Laurent Bercot
For the people who are not on #s6 and have missed the countless resurgences of this discussion, here is my position regarding documentation formats. I hope that by the end of this mail things are quite clear for everyone and I won't need to talk about this again, ever. - Doc formats seem

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread J. Lewis Muir
On 08/31, Laurent Bercot wrote: > > > Of course, you'd also have to convert the existing HTML documentation > > into DocBook and then generate the mdoc and HTML from that. I would > > understand concern over adding a dependency on a potentially heavy > > DocBook toolchain in order to generate

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread Laurent Bercot
Of course, you'd also have to convert the existing HTML documentation into DocBook and then generate the mdoc and HTML from that. I would understand concern over adding a dependency on a potentially heavy DocBook toolchain in order to generate the HTML. One possible way around this, though,

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread J. Lewis Muir
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.

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread Jason Lenz
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

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread J. Lewis Muir
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

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread Guillermo
Hello, El dom., 30 ago. 2020 a las 7:01, Laurent Bercot escribió: > > That would be totally awesome. However, I'd hold off on s6-rc for now, > because I'm in the process of exploring a possible redesign (for better > integration of features that distributions want before packaging and > using

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread Laurent Bercot
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

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread Alexis
Laurent Bercot writes: This is clearly the most advanced conversion ever performed, well done! Thank you! Would you be willing to add a small Makefile that by default invokes the mandoc commands to produce the formatted man pages, and with an install target that installs the source to

Re: [request for review] Port of s6 documentation to mdoc(7)

2020-08-31 Thread Alexis
eric vidal writes: You're welcome. Thank at you to use 66. i enjoy using it - trees are excellent. :-) This is really a hard job to do. Many thanks to make it. You're welcome! But i will do some publicizes about your work that be visible by user. Thank you, much appreciated. :-)