3    Supplementary Documentation

To help meet specific needs when working with the DIGITAL UNIX operating system, Compaq makes available documentation that supplements the DIGITAL UNIX documentation set. Some of these documents are produced by Compaq and others are produced by other organizations and provided by Compaq.

The Documentation CD-ROM, Operating System CD-ROM, Associated Products CD-ROMs volumes 1 and 2 all contain supplementary documentation. Much of this documentation pertains to individual components.

For example, the Associated Products Volume 1 CD-ROM contains installation guides for the Multimedia Services for DIGITAL UNIX run-time environment, DECevent, and the Porting Assistant. Other component-specific information includes release notes, Software Product Descriptions (SPD), and user information.

This Documentation Overview does not list all of the supplementary documentation on the CD-ROMs, but it does provide some guidance in the following sections.

3.1    Documentation CD-ROM

You can access the supplementary documentation described in the following sections by clicking on the bookshelf called Supplementary Documentation on the Documentation CD-ROM. Links to some of this documention are also provided on other bookshelves.

Much of this documentation is provided in both HTML and PDF formats; some is provided only in one of the two formats. If your system is configured as suggested, you can click on the HTML link to view the document in your Web browser or click on the PDF link to view the document in Acrobat Reader.

3.1.1    CD-ROM Contents Listing

This is an online version of the document called DIGITAL UNIX Version 4.0E CD-ROMs, which is included in the DIGITAL UNIX media kit. It provides brief listings of the components on the CD-ROMs in the media kit.

3.1.2    DIGITAL UNIX Year 2000 Readiness

The DIGITAL UNIX Year 2000 Readiness document contains information about the DIGITAL UNIX Year 2000 program to help you prepare your system for the turn of the century. It also includes other important Year 2000 information on previous DIGITAL UNIX versions and layered products, and describes testing methodologies and guidelines.

Included in this document are links to related Web sites.

3.1.3    Name Server Operations Guide for BIND

Distributed by the Internet Software Consortium, the Name Server Operations Guide for BIND describes the Berkeley Internet Name Domain (BIND) Release 4.9.3 and its implementation as an Internet name server for BSD-derived operating systems.

3.1.4    New and Changed Features from Prior Releases

The New and Changed Features from Prior Releases document is a new HTML listing of the major features that were introduced and changes that were made to the DIGITAL UNIX operating system from Version 4.0 through Version 4.0D. The information in this document was originally presented in the New and Changed Features chapter of the operating system Release Notes for each of those versions.

3.1.5    sendmail Installation and Operation Guide

The sendmail Installation and Operation Guide describes the configuration file for Version 8.7 of the sendmail utility, which implements a general-purpose internetwork mail routing facility under the DIGITAL UNIX operating system.

The sendmail utility is not tied to any one transport protocol -- its function may be likened to a crossbar switch, relaying messages from one domain into another. In the process, it can do a limited amount of message header editing to put the message into a format that is appropriate for the receiving domain. All of this is done under the control of a configuration file.

3.1.6    Java Documentation

The DIGITAL UNIX operating system includes a Java Development Kit (JDK), which provides tools to develop and run Java applets and programs on the DIGITAL UNIX operating system.

Access to the Java documentation depends upon whether the Java Development Kit is installed on your system and how your system administrator has set up your system. Clicking on Java Overview on the Supplementary Documentation bookshelf takes you to a page that provides information about viewing the Java documentation. This page also provides a Web link to the JavaSoft JDK documentation at the Sun Microsystems Java site.

3.1.7    DECwindows Documentation

The books in this section are designed to aid programmers who are creating or modifying applications that use the DECwindows graphical user interface.

3.1.8    ToolTalk Service Documentation

ToolTalk is an interapplication communication service that is included as part of the Common Desktop Environment. ToolTalk provides a way for applications and desktop components to request services of each other and to announce events. The following books provide information about the ToolTalk service:

See also the Common Desktop Environment: ToolTalk Messaging Overview in the Windows Programming area of the core documentation set.

3.1.9    Documentation for the X Window System

The documentation described in this section pertains to X Windows System, Version 11, Release 6. These documents are provided by the X Consortium.

3.1.10    Working in a non-English Environment

The following guides provide language-specific information and describe the features of several non-English languages supported on the DIGITAL UNIX system:

3.2    Operating System CD-ROM

The documentation described in this section is included on the DIGITAL UNIX Operating System CD-ROM. Some of this documentation is available only when you install the software it describes.

3.2.1    Software Product Descriptions

A Software Product Description (SPD) is the legal description of the DIGITAL UNIX product. It describes the software and gives information about its capabilities and about the hardware it supports.

PostScript versions of the SPDs are located on the CD-ROM in the mnt_point/DOCUMENTATION/POSTSCRIPT directory. The files are named as follows:

Digital_UNIX_Operating System_SPD.ps
Digital_UNIX_C_Developers_Extensions_SPD.ps
Digital_UNIX_Server_Extensions_SPD.ps
Prestoserve_for_Digital_UNIX_SPD.ps
Digital_UNIX_Logical_Storage_Manager_SPD.ps

3.2.2    Listings of Fixes Made to the Operating System

Compaq maintains lists of fixes it makes to each version of the DIGITAL UNIX operating system. Known as CLDs (for Customer Log Desk), these text files are located on the CD-ROM in the mnt_point/DOCUMENTATION/TEXT directory. The files are named as follows:

Digital_UNIX_V3_2C_CLD_Fixes.txt
Digital_UNIX_V3_2D_CLD_Fixes.txt
Digital_UNIX_V3_2G_CLD_Fixes.txt
Digital_UNIX_V4_0_CLD_Fixes.txt
Digital_UNIX_V4_0A_CLD_Fixes.txt
Digital_UNIX_V4_0B_CLD_Fixes.txt
DIGITAL_UNIX_V4_0D_CLD_Fixes.txt
DIGITAL_UNIX_V4_0E_CLD_Fixes.txt

3.2.3    X Image Extension Documentation

The X Image Extension (XIE) code (developed by the X Consortium) provides a powerful mechanism for the transfer and display of virtually any image on X-capable hardware. Documentation for XIE is installed in compressed format in the /usr/share/doclib/xie directory.

Before you can view or print a copy of one of the XIE documents, you must uncompress it using the gunzip command. For information about gunzip, see the gzip(1) reference page.

The following list describes the XIE documentation. The names of the individual files are listed after the titles.

3.2.4    Display PostScript Documentation

The Display PostScript system is described in the PostScript Language Reference Manual, which is included in the printed version of the DIGITAL UNIX documentation set. Supplemental documentation from Adobe Systems Incorporated is installed in compressed format in the /usr/share/doclib/dps directory. Before you can print or view this documentation, you must uncompress the files using the uncompress command. See the compress(1) reference page for information.

The following list describes the supplemental Display PostScript documentation. The names of the individual files are listed after the titles.

3.3    Associated Products CD-ROMs

The Associated Products CD-ROMs contain documentation for various components of DIGITAL UNIX. The document called DIGITAL UNIX Version 4.0E CD-ROMs, described in Section 3.1.1, provides a list of the applications located on these CDs, as do the 00README.TXT files located on the CDs.

Both CDs now include a graphical user interface that you can use to access documentation and to install product software from within the Netscape browser. To use this interface, invoke Netscape and go to the following location:

file:/<mount_point>/index.html

A list of products on the CD-ROM will be displayed. When you click on a product name you will be given the option to install the product or access the documentation, if applicable.

To view Bookreader or PostScript files while using Netscape, your system will need to be configured so that it will recognize the file type of the file you select and will invoke Bookreader or a PostScript viewer.