You can buy many proprietary books with helpful information. Most people
praise the O'Reilly brand very highly. However, do consider supporting freely
modifiable and redistributable manuals such as this one when possible. If you
want hard copy, purchasing free manuals from the Free Software Foundation
(available at many bookstores, such as Borders, and direct from the FSF)
supports the creation of more free software.

The confusing variety of documentation sources exists for many reasons. For
example, info is supposed to replace man, but
man hasn't disappeared yet. However, it's nice to know that so
much documentation exists!

So where to look for help? Here are some suggestions:

Use the man pages and the --help or -h
option to get a quick summary of a command's syntax and options. Also use
man if a program doesn't yet have an info page.

Use info if a program has info documentation.

If neither of those work, look in /usr/doc/packagename.

/usr/doc/packagename often has Debian-specific
information, even if there's a man page or info page.

Use the HOWTOs for instructions on how to set up a particular
thing, or information on your particular hardware. For example, the Ethernet
HOWTO has a wealth of information on ethernet cards, and the PPP HOWTO explains
in detail how to set up PPP.

Use the Debian Documentation Project manuals for conceptual explanations and
Debian-specific information.

Using man pages is discussed above in The command line and
man pages, Section 4.1. (It's very simple: press the spacebar
to go to the next page, and press q to quit reading.)
info, viewing files in /usr/doc, and asking for help
from a person are all discussed in this chapter.

5.2 Using info

5.3 Viewing text files with more and less

Use these to view some docs. Mention zless and when to use it.

5.4 HOWTOs

In addition to their books, the Linux Documentation Project has made a series
of short documents describing how to set up a particular aspect of GNU/Linux.
For instance, the SCSI-HOWTO describes some of the complications of using SCSI
--- a standard way of talking to devices --- with GNU/Linux. In general, the
HOWTOs have more specific information about particular hardware configurations,
and will be more up to date than this manual.

There are Debian packages for the HOWTOs. doc-linux-text contains
the various HOWTOs in text form; while the doc-linux-html package
contains the HOWTOs in (surprise!) browsable HTML format. Note also that
Debian has packaged translations of the HOWTOs in various languages that you
may prefer if English is not your native language. [9] If you've installed one of these,
you should have them in /usr/doc/HOWTO. However, you may be able
to find more recent versions on the net on the LDP Project home page.

5.5 Getting help from a person

The correct place to ask for help with Debian is the debian-user mailing list
debian-user@lists.debian.org.
If you know how to use IRC (Internet Relay Chat), there is a
#debian channel on irc.debian.org. You can find
general GNU/Linux help on the comp.os.linux.* Usenet hierarchy.
You can search past Usenet questions and answers with the DejaNews service. It is also
possible to hire paid consultants to provide guaranteed support services.
The Debian web site has more
information on many of these resources.

Again, please do not ask the authors of this tutorial for help. We
probably don't know the answer to your specific problem anyway; if you mail
debian-user, you will get higher-quality responses, and more
quickly.

Always be polite and make an effort to help yourself by reading the
documentation. Remember, Debian is a volunteer effort and people are doing you
a favor by giving their time to help you. Many of them charge hundreds of
dollars for the same services during the day.

5.5.1 Dos and Don'ts of asking a question

DO read the obvious documentation first. Things like command options and what
a command does will be there.

DO check the HOWTO documents if your question is about setting up something,
such as PPP or Ethernet.

DO try to be sure the answer isn't in this tutorial (though we realize an index
would be helpful---we're working on it!).

DON'T be afraid to ask, after you've made a basic effort to look it up.

DON'T be afraid to ask for conceptual explanations, advices, and other things
not often found in the documentation.

DO include any information that seems relevant. You'll almost always want to
mention the version of Debian you're using. You may also want to mention the
version of any pertinent packages: the command dpkg --status
packagename will tell you this. It's also useful to say what
you've tried so far and what happened. Please include the exact error
messages, if any.

DON'T apologize for your ignorance, or make excuses for being a newbie.
There's no reason everyone should be a GNU/Linux expert to use it, any more
than everyone should be a mechanic to use a car.

DON'T post or mail in HTML. Some versions of Netscape and Internet Explorer
will post in HTML rather than plain text. Most people will not even read these
posts, because they are difficult to read in most mail programs. There should
be a setting somewhere in the preferences to disable HTML.

DO be polite. Remember that Debian is an all-volunteer effort, and anyone who
helps you is doing it just because they're a nice person.

DO re-mail your question to the list if you've gotten no responses after
several days. Perhaps there were lots of messages and it was overlooked. Or
perhaps no one knows the answer --- if no one answers the second time, this is
a good bet. You might want to try including more information the second time.

DO answer questions yourself, when you know the answer. Debian depends on
everyone doing their part --- if you ask a question, and later on someone else
asks the same question, you'll know how to answer it. Do so!

5.6 Getting information from the system

When diagnosing problems or asking for help, you'll need to get information
about your system. Here are some ways to do so.