LinuxQuestions.org
Download your favorite Linux distribution at LQ ISO.
Go Back   LinuxQuestions.org > Forums > Non-*NIX Forums > General
User Name
Password
General This forum is for non-technical general discussion which can include both Linux and non-Linux topics. Have fun!

Notices

Reply
 
Search this Thread
Old 02-25-2009, 04:25 PM   #1
noir911
Member
 
Registered: Apr 2004
Location: Baltimore, MD
Posts: 681

Rep: Reputation: Disabled
Linux manpages - frustrating


Just installed netcat on OpenSUSE 10.3 - typing nc in the command line shows nc: command not found. SUSE folks have renamed "nc" to "netcat" Anyhow, read the manpage - man netcat and at the bottom it says: "SEE ALSO
/usr/share/doc/netcat/README" - do a less /usr/share/doc/netcat/README from the shell and get error: /usr/share/doc/netcat/README: No such file or directory

Give up and read OpenBSD's excellent nc manpge (http://www.openbsd.org/cgi-bin/man.c...86&format=html)
 
Old 02-25-2009, 04:33 PM   #2
alan_ri
Senior Member
 
Registered: Dec 2007
Location: Croatia
Distribution: Debian GNU/Linux
Posts: 1,733
Blog Entries: 5

Rep: Reputation: 127Reputation: 127
So,what's your question?
 
Old 02-25-2009, 04:38 PM   #3
XavierP
Moderator
 
Registered: Nov 2002
Location: Kent, England
Distribution: Lubuntu
Posts: 19,174
Blog Entries: 4

Rep: Reputation: 428Reputation: 428Reputation: 428Reputation: 428Reputation: 428
Manpages have been complained about ever since non-developers started using it. This is why there are so many blogs/wikis/webpages devted to doing things in Linux. Unfortunately, as with all documentation, they haven't really changed and the only answer is to write something easier to read yourself.

Though I notice that the "excellent" nc page for BSD is merley more detailed than for Linux. They are both still a PITA to read through, imo.
 
Old 02-25-2009, 05:17 PM   #4
alan_ri
Senior Member
 
Registered: Dec 2007
Location: Croatia
Distribution: Debian GNU/Linux
Posts: 1,733
Blog Entries: 5

Rep: Reputation: 127Reputation: 127
Xavier,I agree with you almost completely.Some man pages are really good and some need improvement.I don't like posts like the one from OP here in this thread (post no.1) because they are not doing any good to any Linux user.
BTW,the problem that OP have is solved by running this command;
Code:
less /usr/share/doc/packages/netcat/README

Last edited by alan_ri; 02-25-2009 at 05:52 PM. Reason: a little correction
 
Old 02-25-2009, 05:27 PM   #5
SlowCoder
Member
 
Registered: Oct 2004
Location: Southeast, U.S.A.
Distribution: Fedora (Desktop), CentOS (Server), Knoppix (Diags)
Posts: 934

Rep: Reputation: 38
Man pages are rather terse, but once you get used to them, they're no big deal to get through. In the mean time, try to use them, and if you can't figure them out, find your answers on the web.
 
Old 02-25-2009, 05:44 PM   #6
billymayday
Guru
 
Registered: Mar 2006
Location: Sydney, Australia
Distribution: Fedora, CentOS, OpenSuse, Slack, Gentoo, Debian, Arch, PCBSD
Posts: 6,678

Rep: Reputation: 122Reputation: 122
Some are terse, bordering on useless, some are great. I'd use the rsync man page as an example of a really useful one, lots of good examples for a pretty complex program (or at least very optionable - new word there).

Can't find a really useless on at the moment, but they are out there.
 
Old 02-25-2009, 07:12 PM   #7
jschiwal
Guru
 
Registered: Aug 2001
Location: Fargo, ND
Distribution: SuSE AMD64
Posts: 15,733

Rep: Reputation: 654Reputation: 654Reputation: 654Reputation: 654Reputation: 654Reputation: 654
The README file would be in /usr/share/doc/packages/netcat/.
ls /usr/share/doc/packages/netcat/
Changelog data README scripts

SuSE used /usr/share/doc/packages/<packagename> for all packages. Other distros use /usr/share/doc/<package_name>-<version>/ instead.

If you have konqueror installed try entering `man:netcat' in the address bar. That will give you a more readable html version.
You can also run `man -t netcat | kghostview -' for a postscript version. Both should be easier to read.

In konqueror, you can also read info manuals the same way: `info:bash'.
 
Old 02-27-2009, 09:28 AM   #8
schneidz
Senior Member
 
Registered: May 2005
Location: boston, usa
Distribution: fc-15/ fc-19-live-usb/ aix
Posts: 3,819

Rep: Reputation: 586Reputation: 586Reputation: 586Reputation: 586Reputation: 586Reputation: 586
for some reason i find the die.net man pages more eye-soothing.
 
  


Reply


Thread Tools Search this Thread
Search this Thread:

Advanced Search

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is Off
HTML code is Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
LXer: Even More Madcap Manpages - Linux and Unix Laughs LXer Syndicated Linux News 0 11-30-2008 03:10 PM
more about manpages bigjohn Linux - Newbie 1 03-04-2004 09:07 PM
why linux is frustrating rosko Linux - Software 64 08-09-2003 03:03 PM
most frustrating linux problem bogler General 7 02-25-2003 04:45 AM


All times are GMT -5. The time now is 10:45 AM.

Main Menu
My LQ
Write for LQ
LinuxQuestions.org is looking for people interested in writing Editorials, Articles, Reviews, and more. If you'd like to contribute content, let us know.
Main Menu
Syndicate
RSS1  Latest Threads
RSS1  LQ News
Twitter: @linuxquestions
identi.ca: @linuxquestions
Facebook: linuxquestions Google+: linuxquestions
Open Source Consulting | Domain Registration