|
|
Subscribe / Log in / New account

New online man pages for Debian

New online man pages for Debian

Posted Feb 2, 2017 20:06 UTC (Thu) by flussence (guest, #85566)
Parent article: New online man pages for Debian

I recently discovered man(1) itself is capable of displaying a given page in the user's default $BROWSER. Unfortunately, it looks like nobody who wrote that feature ever used it to see if it works — the HTML rendering of gcc's manpage is unreadable, and due to a race condition sometimes it deletes the file before the browser can open it.

I wouldn't mind installing something like debiman if it could be used offline similarly. I've missed having something like Konqueror back in the day (which had really nice native man/info page rendering).


to post comments

New online man pages for Debian

Posted Feb 2, 2017 22:00 UTC (Thu) by lsl (subscriber, #86508) [Link]

The varying font size in the HTML output for gcc(1) looks interesting.

For nice-looking man pages I prefer the Postscript (or PDF) version combined with an unobtrusive viewer program.

New online man pages for Debian

Posted Feb 3, 2017 7:37 UTC (Fri) by mstapelberg (subscriber, #66308) [Link]

> Unfortunately, it looks like nobody who wrote that feature ever used it to see if it works

There’s actually a paper about the grohtml backend which man(1) uses: https://www.gnu.org/software/groff/grohtml.pdf

I can assure you that the authors have actually taken great care to ensure it looks good on the manpages they checked at the time — more than 10 years ago! What you’re seeing likely is the usual bitrot.

> I wouldn't mind installing something like debiman if it could be used offline similarly. I've missed having something like Konqueror back in the day (which had really nice native man/info page rendering).

debiman can easily be used offline, provided you don’t mind the bandwidth, disk space (3GB for Debian unstable, about 10GB for all suites) and CPU hours to generate/update the corpus (see https://github.com/Debian/debiman/blob/master/PERFORMANCE.md for details).

See https://github.com/Debian/debiman/#development-quick-start for instructions on how to install, run and browse the output. If you run into any issues or have any questions, a GitHub issue is the best way to get them resolved :).

If all you’re interested in is browsing locally available manpages in HTML, you can use the same renderer which manpages.debian.org uses: install the “mandoc” Debian package and use mandoc -Thtml <file>, possibly in a little script to directly open the result in your browser.

Hope that helps!

New online man pages for Debian

Posted Feb 3, 2017 17:37 UTC (Fri) by ianmcc (subscriber, #88379) [Link] (5 responses)

I used to use konqeror a lot for the info: browsing. The only usable 'info' browser I have ever encountered. I haven't used it recently though, and I've switched distros in the meantime. Unfortunately it doesn't work on kubuntu 16.10 :-( Pretty hard to google for 'info', so not obvious how to get it working again. Sooner or later I'll miss it a lot.

New online man pages for Debian

Posted Feb 3, 2017 18:57 UTC (Fri) by flussence (guest, #85566) [Link] (4 responses)

You might like "pinfo" - it uses a lynx-like keyboard setup (and palette), which makes for a much nicer experience than the default info program, imho.

New online man pages for Debian

Posted Feb 3, 2017 23:11 UTC (Fri) by mathstuf (subscriber, #69389) [Link] (3 responses)

There was a script I found a while ago called "ilm" for "info like man" which took info pages and made them act like man (that is, with a sensible pager).

New online man pages for Debian

Posted Feb 3, 2017 23:20 UTC (Fri) by jwilk (subscriber, #63328) [Link] (2 responses)

This one?
https://lists.fedoraproject.org/pipermail/devel/2013-May/...

I hoped for something more sophisticated...

New online man pages for Debian

Posted Feb 3, 2017 23:35 UTC (Fri) by mathstuf (subscriber, #69389) [Link] (1 responses)

Looks like it. I don't use it much, but it's better than info at least.

New online man pages for Debian

Posted Jan 14, 2023 20:38 UTC (Sat) by jwilk (subscriber, #63328) [Link]

After 5 years of sweet procrastination, I wrote my own info viewer with man(1)-like UI:

https://github.com/jwilk/informan


Copyright © 2025, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds