Jan Braun:

2) runit has manpages. s6 has HTML. :(

Daniel J. Bernstein had something to say on that subject, two decades ago. See the "Notes" section of http://cr.yp.to/slashdoc.html .

I generate both manual pages and HTML from a common DocBook XML master in the nosh toolset. And the DocBook XML is itself readable directly with a WWW browser. http://jdebp.uk./Softwares/nosh/guide/commands/setuidgid-fromenv.xml is a copy of one such DocBook XML master, for example. It's on the WWW, and the packages also install it locally, for off-line reading.

M. Pape did some of the manual pages for some operating system's versions of daemontools, converting M. Bernstein's HTML pages into roff. For djbwares I converted everything into DocBook XML, and the same holds for djbwares as for the nosh toolset. There is a DocBook XML master that one can view in a WWW browser directly (both on-line and off-line), generated HTML pages, and generated manual pages readable with man. http://jdebp.uk./Softwares/djbwares/guide/commands/setuidgid.xml is a copy of one such DocBook XML master, for example. This is the source for the "man setuidgid" manual and the source for http://jdebp.uk./Softwares/djbwares/guide/setuidgid.html .

I even filled in the manual pages that M. Pape hadn't done and that M. Bernstein hadn't originally written in HTML, and updated some of the doco. See http://jdebp.uk./Softwares/djbwares/guide/commands/caldate_easter.xml and http://jdebp.uk./Softwares/djbwares/guide/commands/dnscache.xml for examples of that.

Reply via email to