8    Using Online Documentation

In addition to online help, which is already integrated into many applications, all other documentation associated with the operating system, including books and reference pages, can be viewed online from the CD-ROM labeled Documentation Volume 1.

The following topics are discussed in this chapter:

8.1    Supported Documentation Formats and Online Viewers

The online documentation set is available in both Hypertext Markup Language (HTML) and Portable Document Format (PDF) versions. Two viewers are supported:

8.2    Mounting the Documentation CD-ROM

The operating system documentation is shipped on the CD-ROM labeled Documentation Volume 1. Mount instructions are also included on the inside of the CD-ROM jacket.

Follow these steps to mount the CD-ROM so that you can view the online documentation set with Netscape Navigator or Acrobat Reader:

  1. Log in as root or use the su command to gain root privileges.

  2. Insert the CD-ROM into your system's CD-ROM drive.

  3. Use the following command to mount the CD-ROM on /usr/share/doclib/online if you have only one CD-ROM attached to your system: 

    # mount -r /dev/disk/cdrom0c /usr/share/doclib/online

    If you have more than one CD-ROM device, enter a command similar to the following to determine the CD-ROM devices connected to your system. Then, decide which CD-ROM device you want to use. 

    # ls /dev/disk/cdrom*c
/dev/disk/cdrom0c
/dev/disk/cdrom1c

8.3    Viewing Online Documents with Netscape

Follow these steps to view the online documentation set with Netscape Navigator:

  1. Mount the Documentation CD-ROM as described in Section 8.2.

  2. Start Netscape Navigator by using one of the following methods:

  3. When the Netscape Navigator is displayed, click on the Home icon to access the home page located at: 

     /usr/doc/netscape/Digital_UNIX.html

  4. Click on the Documentation link to go to the Documentation home page.

  5. Documentation categories are listed in the frame down the left side of the page. Click on a category to display links to HTML and PDF versions of the individual books in that category.

Section 8.5 describes how to install Acrobat Reader. The Adobe Acrobat Reader Online Guide, available from the Acrobat Reader Help menu, provides information about setting up Netscape Navigator to view PDF files.

8.4    Netscape Application Integration

The following information is provided to help you when you use Netscape applications on this operating system:

8.4.1    Mosaic-to-Netscape Bookmark Conversion

If Mosiac was your previous browser, you need to convert your Mosaic hotlist files to equivalent Netscape Communicator bookmark files. To accomplish this conversion, invoke the shell script /usr/doc/netscape/hot-convert.sh with no arguments.

It is recommended that you define the Global Types File and Global Mailcap File used by Netscape as follows:

These files allow Netscape to invoke the proper helper applications for viewing file types not directly viewable in Netscape. You can do this by selecting Preferences... from the Netscape Options menu. Then select Helper Applications and enter the correct values.

For more information about using Netscape, refer to the Netscape Navigator Online Handbook, which is available by clicking on the link to Other documentation on the home page.

8.5    Installing Acrobat Reader

The PDF versions of the online documents are best viewed by using Acrobat Reader as a Netscape Navigator helper application. This section tells you how to install Acrobat Reader on your system.

Note

Acrobat Reader requires 16 MB of free disk space. Use the df command to ensure that the file system where you install Acrobat Reader has sufficient space before beginning this installation.

Follow these steps to install Acrobat Reader on your system:

  1. Log in as root or use the su command to gain root privileges.

  2. Mount the Documentation CD-ROM as described in Section 8.2.

  3. Change to this directory: 

    
# cd /usr/share/doclib/online/ACROREAD

  4. View the following file to find the name of the directory that contains the Tru64 UNIX version of Acrobat Reader: 

    
# more 00README.TXT

  5. Change to the directory that contains the Tru64 UNIX version of Acrobat Reader: 

    # cd  tru64_unix_directory

  6. View the following file for information about uncompressing the installation file and running the installation script: 

    
# more 00README.TXT

  7. Follow the instructions in the 00README.TXT file to uncompress the installation file and run the installation script.

  8. After you read the license agreement, enter accept to accept the license terms and continue.

  9. Select an installation directory for Acrobat Reader. The default is /usr/local/Acrobat3. If you accept this default and the directory does not exist, it is created automatically.

    The installation completes and you see the command line prompt. Section 8.6 describes how to start and use Acrobat Reader once it is installed.

The Adobe Acrobat Reader Online Guide, available from the Acrobat Reader Help menu, provides information about setting up Netscape Navigator to view PDF files.

8.6    Viewing Online Documents with Acrobat Reader

The PDF versions of the online documents are best viewed by using Acrobat Reader as a Netscape Navigator helper application. You can, however, view them directly with Acrobat Reader. You should review the 00README.TXT file in the ACRO_DUX and ACRO_SUP subdirectories under the /usr/share/doclib/online/DOCS directory. These files map file names to document names so that you can locate specific documents.

Follow these steps to view the online documentation set with Acrobat Reader:

  1. Mount the documentation CD-ROM as described in Section 8.2.

  2. Install Acrobat Reader as described in Section 8.5.

  3. Run Acrobat Reader in the background: 

    
# /usr/local/Acrobat3/bin/acroread &

    Refer to the Adobe Acrobat Reader Online Guide, available from the Help menu, for information on how to use Acrobat Reader.

  4. Select Open... from the File menu to open the Open dialog box, where you can select a PDF file.

    The PDF documents are in the /usr/share/doclib/online/DOCS directory on the documentation CD-ROM.

    The 00README.TXT file in both subdirectories maps file names to document names so that you can locate specific documents. You cannot use Acrobat Reader to view text files. To view this file you might consider using the more command. For example:


    #     more /usr/share/doclib/online/DOCS/ACRO_DUX/00README.TXT

8.7    Copying Online Documentation to Disk

Instead of reading the online documentation set from the CD-ROM, you can copy the documentation files to a disk on your system. Copying the documentation files to a disk eliminates the need to keep the CD-ROM permanently mounted. The entire set of online documentation files consumes about 218 MB of disk space in the /usr file system.

Follow these procedures to copy the documentation files to a disk on your system. Use the same directories shown in the examples so you will not have to modify library bookshelf files.

  1. Log in as root or use the su command to become superuser.

  2. Insert the Documentation CD-ROM into the drive (assume the CD-ROM device name is /dev/disk/cdrom0c).

  3. Mount the CD-ROM on /mnt: 

    
# mount -r /dev/disk/cdrom0c /mnt

  4. Enter commands similar to the following examples to copy the online documents from the CD-ROM to the right subdirectories in the /usr/share/doclib/online/DOCS directory. This example illustrates the process with the CD-ROM mounted on the /mnt directory.

    Note

    The backslashes ( \ ) in the following examples represent line continuation characters; do not enter them on the command line.

  5. Unmount the CD-ROM: 

    # cd /
# umount /mnt

Follow the instructions in Section 8.3 if you want to start Netscape Navigator or Section 8.6 if you want to start Acrobat Reader.