Advanced

I want my man pages back

Posted by Scott_Ruecker on · 13 comments
Linux DevCenter; By Carla Schroder
Mail this story
Print this story

Man pages are an endangered species. Give me back my man pages!
HTML docs are nice, but not very readable on a headless server that does not run X windows. First of all, hunting down whatever weirdo directory the HTML help docs is not a fun use of time. Then reading them in a text HTML browser is an even bigger waste of time, if you even have one installed.

Full Story

  Nav
» Read more about: Story Type: News Story; Groups: Community, Linux

» Get new stories by e-mail: nightly or as they are published

« Return to the newswire homepage

  Related stories
» More like this

Comments (13)

I dunno, try this in Konqueror

man:gawk

Quite readable in a browser, even if it's not lynx.

It's quite a handy browser, try something like fish://name.of.ssh.server one day, as well. And there's much other stuff it does.
What if you're not running X Windows?
did either of you read the actual article? :)
Yes. And Lynx works quite well for reading HTML docs. I hate info pages though.

Maybe the poster of the article should try Debian. Debian mandates man pages for all applications.
> Debian mandates man pages for all applications.

One of many, many reasons to run Debian :)
If you're familiar with Debian, then you've seen the sorry excuses of man pages that are written just to fulfill Debian's requirements. Like ImageMagick- compare man convert, for one example, to the HTML docs. man convert is pretty much just a pointer to 'convert -help', which is a barebones option summary, and /usr/share/doc/imagemagick/www/convert.html, which is more comprehensive and contains useful examples. And that's not even the worst offender- I wish I could remember which command it is, the man page says in effect "Debian makes me include this but they can't make me put useful information in it."

That last example is a mere exception, but I have seen some man pages merely summarize and point to info pages. That said, the man pages are there and either provide the information, or point to where you can get the information. That's more than can be said for other distro's.

I really wish someone would write a clever help application though. Gnome's Yelp has potential but it's too bare-bones and doesn't link/index all documentation on the system. A Yelp that could automagically find application documentation (e.g. searching for files/folders named "manual" or "docs" alongside all man and info pages) with a powerfull search and an auto-indexer would be great.
> "Debian makes me include this but they can't make me put useful information in it."

Unfortunately true, still, many apps do put useful info there. We need to tell the developers that we need that.

The march of the forked-tongue poopyheads

No, the subject has nothing to do with anything. I just like typing it. Consider it an homage laid at the temple of TC.

But...

YES!!!!

man is there. Man this, man that from a console and you have a wealth of information.

In fact, T, if I may call you by your first initial, or, rather, by your handle's first initial, which is not to imply that you are some old piece of baggage, your mention of info informs us just a little on some other issues (cough!! GPLV3).

Man is lovely, elegant, and there. To date, alternatives have not met its standard. Some (info) have gone above and beyond the call of duty to not meet its standard.



> YES!!!!

You say it so well, Dino. What else is there to add? Great article TC.
And I second it. Motion carried--man is the best way to get information. Oh, how I wish Perl used the man pages more effectively.

I do wish for better tools to search man pages.

And while it's rare to wait more than a second or two for the man page, in this era of relatively enormous hard drives, I'd also like to know how to force all man pages to be uncompressed and preformatted.

This is a ripe topic for articles... articles about creating and installing man pages, how to fix those annoying font problems that sometimes occur, and how to convert other formats to man... Maybe a longer article about why man pages are cool.
Call me T, call me Samsonite, just don't call me late for dinner. :)

an article about man pages? why not.....

Post a comment

A free account is needed to post. Write your comment here first: your text is kept in this browser while you sign up or log in, and is waiting for you when you come back.

Your message:
|||||
10
Markdown: **bold**, *italic*, [text](https://link), - lists, > quotes, $x^2$ for math. Formatting help

Sign up and post (it is free)  or  Log in and post