ramfree17 Posted April 21, 2003 Report Share Posted April 21, 2003 (edited) Browse: [About the FAQ forum] [table of contents] [FAQs] [contribute] [GQ: General Questions not covered in the other sections] GQ-01 : How do I find (additional) help? There may come a time in this Linux forum of ours where you will hear a shout of RTFM! Many Linux Gurus get RTFM rage as new users assume that they are some kind of helpline. There is a reason for this, nearly all of the Linux and Unix tools feature a lot of documentation. This is great for the user, as it means you dont have to wait for a more experienced Linux user to help you. :) This post aims to provide a selection of links to manuals of all sizes and shapes, so that the user does not have to search for them (god forbid the new Linux user having to find the manuals themselves:)) The man command How to use man Now our first useful resource is the man command, this is used in the following way: man <package name> It can be executed by any Linux user at all ;) Now, man is a command that formats and shows the manual pages for a particular tool, useful huh? Now, man can be used very easily, sometimes however I have people asking me how to exit man, this is very easy, use q Pressing the down arrow lets you proceed onto the next page, the man pages typically list all the command line switches of the tool, as well as some interesting configuration information. To test this command out type: $ man man Now, read on down, this is the full manual page for the man command, it should be split in nice easy to read sections. This is one of the most useful commands on Linux :) If you are not sure what command does what you want, you can use $ man -k <keyword> to search for utilities that have the keyword in their description. Instead of man -k, you could also use apropos or whatis. When to use man The time when it is ideal to use man is if you have a question such as What is foo-bar and how do I use it? or I wonder if foo-bar can do blah-de-blah. Since all the functions are listed under the man page then you can use its wealth of resources, as well as read the short description of the function. Also the man page should be used as the first resource before starting to look elsewhere. The info command The info (/usr/bin/info) command is thought to be the replacement of the almost obsolete "man" format for reading the documentation of computer programs. Most of the GNU programs have their documentation written in info format, though they mantain a copy of that documentation in man format (many times that man page is not updated, and points to the info version). You can see how to use "info" for reading documentation either by: man info or info info It is also possible to access man and info pages graphically in KDE. To do this you will need to open up Konqueror and in the urlbar type man:/ Similarly for info pages you can type info:/ They can also be accessed through the KDE Help Center if it is installed khelpcenter The help built in The bash built-in commands, are only documented on "man bash" or "info bash" which are difficult to use due to its heavy size. So to get quick help on bash builting commands, you can use the built in help command. Example: help alias alias: alias [-p] [name[=value] ... ] `alias' with no arguments or with the -p option prints the list of aliases in the form alias NAME=VALUE on standard output. Otherwise, an alias is defined for each NAME whose VALUE is given. A trailing space in VALUE causes the next word to be checked for alias substitution when the alias is expanded. Alias returns true unless a NAME is given for which no alias has been defined. Internet Resources LinuxQuestions- This is one of the largest Linux specific forums on the internet, you should NOT automatically think that because these are forums then you should post your question, you shouldnt. This forum has the search feature enabled. So, head right up to the search feature and start searching. Some tips for searching are: 1. Use booleans, AND, OR etc. 2. Make your search as specific as possible 3. Search for only words over two (2) characters long 4. Do not search for "linux" or other such generic terms There are thousands of posts at the site, most of your problems should be covered here. If they're not then :shock: Google - Linux - The little known Linux section of google. This site covers many areas of the Linux online world and there will be some matches for your search. Follow the same searching tips as above. (You can also resort to the standard google search if you are having no luck, make sure, however that you do include the word "linux" in the search. Google - Groups (groups.google.com) Even better resource than the http://google.com/linux you have the Google Groups (an excellent search engine for Usenet discussion forums) for finding answers to your punctual questions. Literally, every question you have has already been answered in Usenet. Next stop, New York, well - almost, actually freshmeat.net now the chances are that your software will be listed on freshmeat/sourceforge. Do a search here for the package name, if it is found then try clicking on the "Project Homepage" link, or the Docs link if there is one; have a thorough read of these and see if your problem is listed as a bug, if it is then there isnt much you can do about it, until the next version comes out :( Also, if there is a SourceForge link check that they don't have a forum such as the KICQ projects here. Have a read around here, this will most likely be where the developers help out. Another place to go will be down the nav-bar on the left is a documentation link, have a look, have a read and see whether your problem is listed there. If it isnt then you have two options: OcUK Linux Forum - We're happy to help if you have read the manuals and have tried to research your problem. Make sure your post includes: 1. The version of the software 2. Your current distro 3. How you installed (i.e. via RPM [urgh evil!] or via .tar.gz [use the source luke!] 4. The exact error message (copy and paste if possible) that was given when your program crashed/the problem occured. If you have a random crash problem, try running from the terminal (xterm, konsole, gnome-terminal) to see this error. If we dont know the answer or you would prefer not to ask @ OcUK then try the aforementioned LQ Forums, or the forums of your chosen package. Also, check distro-specific forums such as The Gentoo Forums. Forums such as these have extensive search features, and often have the developers/gurus of that particular distro on them :) And finally there are our forums, complete with the handy Search link in the upper right hand corner of the page :-) Another valuable resource is IRC (internet relay chat). The best IRC server for help I find is: irc.openprojects.net Here there are many channels such as #gentoo and #fluxbox etc. There is also a general Linux channel @ #linux. If you have BitchX the IRC client then use this: $ BitchX irc.freenode.net /nick <your nickname> /join #<chosen channel> For more information on connecting to IRC see our How To Connect to IRC How-to. Because Linux is free, the software you install may require some work from YOU the user to get working. The vast array helplines that can be found for Windows don't exist in such abundance for Linux and therefore you need to try to help yourself before asking frantically. Linux requires you to put effort in to make your system work properly, I tweak and change my current Gentoo system frequently - and I know I will never have it perfect. If you want a system that works out-of-the-box and you dont want to put any effort in at all - then go back to WIndows and format every 3 months :roll: . The OpenSource community requires both developers and users to put effort in it. Enjoy your Linuxing... /edit - I've written this, and read over it and it sounds like a rant, it isn't a rant, it's a guide for new Linux users, a guide to show people HOW to look for their own information, so that they can try to help themselves. I've picked out what I think are the most helpful guides on the Internet and elsewhere for you to use. Please don't take it as a rant. If you think there are any more useful sites on the internet/resources please PM me and I'll add them to the guide :D NOTE: This was a post made mainly by JeroenM at club-nihil.net and was edited to include some additonal tips from other users. Reference Link(s): http://mandrakeusers.org/index.php?showtopic=2302 http://linuxquestions.org/ http://forums.overclockers.co.uk/ http://freshmeat.net http://forums.gentoo.org man man man apropos man whatis man less info info Edited January 8, 2006 by Tuxiscool Link to comment Share on other sites More sharing options...
Recommended Posts