Red Hat Linux 9: Red Hat Linux Getting Started Guide
Prev	Chapter 1. Getting Started	Next

1.7. Documentation and Help

manual pages, documents that detail usage of important applications and files; INFO pages which break information about an application down by context-sensitive menus; and help files on your Red Hat Linux system or can be easily installed.

1.7.1. Manual Pages

are structured in such a way that users can quickly scan the page for pertinent information, which is important when dealing with commands that they have never previously encountered.

1.7.1.1. Using `man`

Man Pages can be accessed via shell prompt by typing the command man and the name of the executable. For example, to access the man page for the ls command, type the following:

man ls

The NAME field shows the executable's name and a brief explanation of what function the executable performs. The SYNOPSIS field shows the common usage of the executable, such as what options are declared and what types of input (such as files or values) the executable supports. The DESCRIPTION field shows available options and values associated with a file or executable. See Also shows related terms, files, and programs.

Figure 1-11. Reading a Man Page with the Shell Prompt

To navigate the man page you can use the [Page Down] and [Page Up] keys or use the [Spacebar] to move down one page and [B] to move up. To exit the man page, type [Q].

To search a man page for keywords type [/] and then a keyword or phrase and press [Enter]. All instances of the keyword will be highlighted throughout the man page, allowing you to quickly read the keyword in context.

1.7.1.2. Printing a Man Page

to Chapter 8 Printer Configuration for more information), you can print a man page by typing the following command at a shell prompt:

man command| col -b | lpr

The example above combines separates commands into one unique function. man command will output the contents of the command man page to col, which formats the contents to fit within a printed page. The lpr command sends the formatted content to the printer.

1.7.1.3. The `man` Man Page

Just like other commands, man has its own man page. Type man man at the shell prompt for more information.

1.7.2. Red Hat Linux Documentation

HTML, RPM, PDF, and compressed tarball format (.tar.gz) are also available at http://www.redhat.com/docs/. Once you have logged in to your user account, inserting the Documentation CD in your CD-ROM drive should automatically start the Package Management Tool and allow you to install any of the Red Hat Linux documentation. Follow the instructions and choose the documentation you would like to install.

Figure 1-12. Package Management Tool Displaying Documentation Available for Installation

After you have installed the documentation packages you want, you can access them at any time by clicking Main Menu => Documentation.

If you have downloaded individual documentation RPM packages from the Red Hat website at http://www.redhat.com/docs/ you can install these manuals from a shell prompt. Open a shell prompt, and type the following at the command line:

su

Press [Enter]. You will be asked for your root password. Enter the password at the prompt and press [Enter]. You are now logged in as root. To install all of the Red Hat Linux manuals, change to the directory that contains the RPM files and type the following:

rpm -ivh rhl-*.rpm

Press [Enter].

To install only certain manuals, replace rhl-*.rpm with the full file name of the manual that you want to install. For example, the file name for the Red Hat Linux Getting Started Guide will look something like rhl-gsg-en-9.noarch.rpm, so you would type the following to install it on your system:

rpm -ivh /mnt/cdrom/rhl-gsg-en-9.noarch.rpm

Press [Enter]. Type exit at the command line and press [Enter]. This logs you out of the root account and back to your user account.

Now go to Main Menu => Documentation and select the manual you want to read.

Prev	Home	Next
Creating a User Account	Up	Logging Out