IRC channel logs

2024-06-07.log

back to list of logs

<concussious>hi, what kind of tooling are y'all using for manual pages?
<concussious>i sent a mail to debian-hurd, but then I noticed the irc channel
<concussious>i want to upstream my mdoc(7) manual for xf86-input-keyboard, but I want to make sure that is going to be fine for you guys
<concussious>motivation: increasing apropos specificty across freebsd stack
<concussious>do you guys have man pages?
<damo22>concussious: probably best to email bug-hurd at gnu.org
<damo22>concussious: yes we definitely have man pages
<damo22>i think we are using texinfo
<damo22>concussious: our maintainer replied to your email anyway
<concussious>thanks so much! sorry for the noise!
<concussious>am I understanding? "man xf86-input-keyboard" does nothing on hurd?
<youpi>? it's rather man kbd
<youpi>and it does bring the kbd driver manpage
<youpi>from the xf86-input-keyboard package
<concussious>oops, duh, sorry. are you guys using groff for that?
<youpi>for what?
<concussious>rendering the manpage?
<youpi>we're just using man from debian
<concussious>okay, perfect, i think that gives me enough info
<youpi>which apparently depends on groff
<concussious>perfect, thats exactly what i wanted to know, thank you!
<damo22>concussious: thank you for fixing it
<solid_black>hi
<solid_black>I don't think we have man pages, because, uhh, GNU policies, we have info pages instead
<solid_black> https://xkcd.com/912/
<solid_black>the original Mach had man pages for its APIs, though
<solid_black>though I guess what you're asking is wehther or not man(1) works at all in Debian GNU/Hurd, of course it does
<concussious>thanks! some have done it, clear linux (8yr?ago): no man(1)
<damo22>it would be pretty irresponsible to have an official GNU OS project with no man(1)
<concussious>well, i like man(1) enough that i rewrote kbd(4) from man(7) to mdoc(7) just to make apropos work better on freebsd. i only start x when I need a www browser, but i want to make apropos listings very elegant so more people appreciate traditional unix culture of manual pages. that said, i respect lots of computer tribes have different culture
<concussious>its been my main hobby the past few months
<concussious>i don't really understand this driver, but i understand man
<concussious>so, intel's clear linux was the very fastest, i respect those guys don't like man(1) and hope they respect that we do
<concussious>the hurd is very unique thinking also, so i didn't know if you guys only used texi, and maybe had developed a complete set of texinfos to replace man
<solid_black>the Hurd is just a kernel really
<solid_black>as I said, we don't have man pages of our own (at least none that I'm aware of)
<solid_black>it's up to whoever puts together a complete system (based on the kernel, and lots of other software) to include man(1) and man pages, or not
<youpi>i.e. it's up to the distribution
<solid_black>that's what I meant to say, yes (also, hi youpi!)
<youpi>sure, just preferred to put the word on it :) (hi!)
<concussious>that's a great explaination, thanks again
<concussious>that does it for me, thanks everyone