<PaulFertser>
rao: when you install OpenOCD the manual is installed with it, you do not need any servers or Internet access.
<PaulFertser>
That 403 error is new, I will check, thank you for report.
nerozero has quit [Ping timeout: 260 seconds]
<rao>
the man page of openocd is very short...
<rao>
nothing about any of this
<PaulFertser>
Yes, because all the documentation is in the info page.
<PaulFertser>
And the man page is explicit about .
<rao>
yay, another method of delivering manuals /s <standards xkcd>
<rao>
anyway, thanks for your help
<rao>
I'll fix up my board and then try to program it
Hawk777 has joined #openocd
<PaulFertser>
rao: Texinfo was released in 1986. And it's been the standard documentation format for GNU for the whole time.
<PaulFertser>
Hm, sf broke something, even openocd.org doesn't work properly now.
<PaulFertser>
Yeah, I changed nothing but now it works.
<PaulFertser>
But not fully fixed.
gzlb has quit [Ping timeout: 240 seconds]
gzlb has joined #openocd
Bugies has quit [Ping timeout: 272 seconds]
<karlp>
PaulFertser: I keep tellin gyou no-one gives a shit if info is "standard"
<PaulFertser>
karlp: well, that's how GCC, Binutils and many other essential software documentation is maintained.
<PaulFertser>
Also thanks to Texinfo someone released a real book with ISBN from OpenOCD User Manual, the generated PDF looks really OK.
<PaulFertser>
I personally find it nice to have cross-references, hyper-references, automatic generation of HTML and PDF etc all from a reasonably readable source. The *roff source of manpages feels much harder to use.
<PaulFertser>
I do not see any practical reason to be unhappy with Texinfo.
<karlp>
I'd be happier honestly, I'd be happier if I could have the man page show me a file:///usr/share/blah/index.html link that I could click on and have it open the matching version from my local drive in a browser.
<karlp>
links and things all work there
<karlp>
info the browser is, no matter how much gnu people like to believe ortherwise, unused, unknown, unloved, and unmissed.
<PaulFertser>
Many people love and use KDE, right? Doesn't KDE help system support navigating Info manuals?
<PaulFertser>
Your distro maintainer is free to generate a set of HTML pages from Texinfo and package to /usr/share/ and add a note to the man page why not.