Bookmark this page

Reading Documentation Using pinfo Command

An overview of the GNU Info documentation system, including efficient navigation and searching.

Objectives

After completing this section, students should be able to research answers using GNU Info documentation.

Introducing GNU info

Reading documentation using pinfo command

Man pages have a formal format useful as a command reference, but less useful as general documentation. For such documents, the GNU Project developed a different online documentation system, known as GNU info. Info documents are an important resource on a Red Hat Enterprise Linux system because many fundamental components and utilities, such as the coreutils package and glibc standard libraries, are either developed by the GNU Project or utilize the info document system.

Figure 3.1: pinfo Info document viewer, top directory

Info documentation is structured as hyperlinked info nodes. This format is more flexible than man pages, allowing thorough discussion of complex commands and concepts. Like man pages, info nodes are read from the command line, using either the info or pinfo commands.

Some commands and utilities have both man pages and info documentation; usually, the info documentation will be more in-depth. Compare the differences in tar documentation using man and pinfo:

[student@desktopX ~]$ man tar
[student@desktopX ~]$ pinfo tar

The pinfo info reader is more advanced than the original info command. Designed to match the lynx text web browser keystrokes, it also adds color. Info nodes for a particular topic are browsed with pinfo topic. Enter only pinfo for the info topics directory. New documentation nodes become available in pinfo when their corresponding software packages are installed.

GNU Info vs. man page navigation

The info command uses different navigation keystrokes than does man. The info command was designed to match the keystrokes of the hypertext-aware lynx web browser. Compare the key bindings in the following table:

Table 3.3. pinfo and man, key binding comparison

Navigationpinfoman
Scroll forward (down) one screenPageDown or SpacePageDown or Space
Scroll backward (up) one screenPageUp or bPageUp or b
Display the directory of topicsd-
Scroll forward (down) one half-screen-d
Display the parent node of a topicu-
Display the top (up) of a topicHOME1G
Scroll backward (up) one half-screen-u
Scroll forward (down) to next hyperlinkDownArrow-
Open topic at cursor locationEnter-
Scroll forward (down) one line-DownArrow or Enter
Scroll backward (up) to previous hyperlinkUpArrow-
Scroll backward (up) one line-UpArrow
Search for a pattern/string/string
Display next node (chapter) in topicn-
Repeat previous search forward (down)/ then Entern
Display previous node (chapter) in topicp-
Repeat previous search backward (up)-N
Quit the programqq

References

pinfo info (Info: An Introduction)

  • All Sections

pinfo pinfo (Documentation for 'pinfo')

  • All Sections

The GNU Project http://www.gnu.org/gnu/thegnuproject.html

pinfo(1) and info(1) man pages

Revision: rh124-7-1b00421