Using the Tru64 UNIX Documentation Library

Important: To move between documents in this library area, use the browser's menu and the navigational aids built into the documents themselves. See Navigating between books for more information.


This page discusses the following topics:

Locating the books that you want
Navigating between books
Navigating within a book
Viewing reference pages


Locating the books that you want

The online books are arranged into "bookshelves." Each bookshelf is represented by a bulleted list. The colors are as follows:

General User Documents
Programming Guides
System & Network Administration
Supplementary Documents

The organization of the library is similar to the kit structure of the printed documentation set except that books meeting the needs of multiple audiences appear on several bookshelves. For example, the Security book is on the General User, Programming, and System and Network Administration bookshelves because it serves each of those audiences.

To guide you more quickly to the books you want to read, the colored bullet for each book matches the color coding for the printed subkit corresponding to the bookshelf. For example, the Security book is actually part of the General User subkit, so it has a blue bullet () wherever it is listed.

For complete information on all the books, see the Documentation Overview and the Glossary and Master Index. The descriptions in the Documentation Overview include order numbers for the full printed documentation kit, for the various subkits, and for individual books. Supplementary Documents are not part of any kit or subkit and cannot be ordered from Compaq.


Navigating between books

When you open a book, the browser creates a new window so that you can keep several books open at once. Except for links to the various books from the Master Index, you cannot go directly from one book to another. To open a new book or switch to another book, use the browser's Window menu to return to the library and choose a new book.


Navigating within a book

Because the books in this library come from several different sources, navigation aids differ between books. These are the different kinds of books:

* Books with a Tru64 UNIX or DIGITAL UNIX title page
* Books without a Tru64 UNIX or DIGITAL UNIX title page


[Contents] [Prev Chap] [Prev Sect] [Next Sect] [Next Chap] [Index] [(i)]

Navigating in books with a Tru64 UNIX title page

When you open a book with a Tru64 UNIX title page, you will find a navigation button bar below the book's title on the title page. This button bar looks like the illustration immediately above. (The buttons in the illustration are not active.)

These buttons also appear at the top and bottom of each book file and before each section in a chapter. There are seven different buttons in the button bar. The entire button bar always appears, but some buttons might be blank to show that they are disabled.

The following table describes what the buttons do:

[Contents] This button takes you to the table of contents in the book you are reading.
[Prev Chap] This button searches backward for the first chapter marker earlier in the book than your present location. If you are before the first numbered section of a chapter, you will go to the beginning of the preceding chapter. If you are in one of the numbered sections within a chapter, you will go to the beginning of the chapter you are in.
[Prev Sect] This button searches backward for the first section marker in the current chapter that is earlier than your present location.
[Next Sect] This button searches forward for the first section marker in the current chapter that is later than your present location.
[Next Chap] This button searches forward for the first chapter marker later in the book than your present location.
[Index] This button takes you to the index in the book you are reading.
[(i)] This button opens a new browser window containing the page you are now reading. You can leave this page's window on your acreen while you read other documents.


[Next Chap] [Prev Chap] [Top of Book] [Contents] [Index]

Navigating in books without a Tru64 UNIX title page

When you open a book without a Tru64 UNIX title page, you will find a navigation button bar above the book's title at the top of the title and copyright page. This button bar looks like the illustration immediately above. (The buttons in the illustration are not active.)

These buttons also appear at the top and bottom of the table of contents, each chapter, and the index. There are five different buttons in the button bar, but only buttons that are active appear.

The following table describes what the buttons do:

[Next Chap] This button searches forward for the first chapter marker later in the book than your present location. If you are in the last chapter, this button does not appear.
[Prev Chap] This button searches backward for the first chapter marker earlier in the book than your present location. If you are in the first chapter, this button does not appear.
[Top of Book] This button takes you to the title and copyright information at the beginning of the book. If you are in the title and copyright section, this button does not appear.
[Contents] This button takes you to the table of contents for the book you are reading. If you are in the table of contents, this button does not appear.
[Index] This button takes you to the index for the book you are reading. If you are in the index, this button does not appear.


Viewing reference pages

The reference pages are displayed by an automated tool called webman. This tool might not be installed on your system. If it is installed, webman works in the following way:

  1. When you open webman, webman presents a page that lists the available reference page directories. The list can include custom locations established by your system administrator and enabled by your MANPATH environment variable. The standard locations are:

    /usr/share/man
    Base system reference pages, present if installed. Might not include all of the reference pages, depending on what selection of subsets is installed. Might also include reference pages for layered products if any are installed.

    /usr/dt/share/man
    Common Desktop Environment reference pages, present if installed. Might not include all of the reference pages, depending on what selection of subsets is installed.

    /DOCUMENTATION/HTML/usr/share/man
    Base system reference pages (duplicate of the complete set of files that Compaq supplies for /usr/share/man), present if the documentation CD-ROM is installed.

    /DOCUMENTATION/HTML/usr/dt/share/man
    Common Desktop Environment reference pages (duplicate of the complete set of files that Compaq supplies for /usr/dt/share/man), present if the documentation CD-ROM is installed.

    The order of this list is determined by webman.

    This display also includes a field into which you can enter a keyword for which you want a list of related reference pages. The listing includes hypertext links to the pages in the display.

  2. When you click on a directory from the list, webman presents an alphabetical listing of the contents of that directory. If a given reference page is listed twice, the two files are:

    1. First, an uncompressed file. Typically, this file has been edited by your system administrator to reflect local information.

    2. Second, a compressed file. This file is the original file supplied by Compaq.

  3. When you choose a file from the directory listing, webman displays the selected reference page.

Within a reference page display, cross-references to other reference pages are hypertext links. A given hypertext link can resolve to more than one possible file. The search order is as follows:

  1. Directories are searched in the order defined by the initial list. As soon as a file is found that matches the cross-reference, the search ends and webman displays that file.

  2. Within a given directory, if there are both an uncompressed file and a compressed file, the uncompressed file is given preference.