8    Documentation Notes

This chapter contains release notes that apply to the operating system documentation. It provides information on the following:

• Software Product Description (Section 8.1)

• Changes to the documentation set (Section 8.2)

• Netscape problem with the Search by Keyword feature (Section 8.3)

• AltaVista search (Section 8.4)

• Online help (Section 8.5)

• Reference pages (Section 8.5.3)

8.1    Software Product Description (SPD) Replaced by QuickSpecs

The Software Product Description (SPD) has been replaced by the Tru64 UNIX QuickSpecs. For a description of this release of Tru64 UNIX and information about its capabilities and the hardware it supports, see the QuickSpecs.

8.2    Changes to the Documentation Set

For this release of the operating system, a new hardware management manual has been added to the documentation set and significant changes have been made to the Security and Writing Software for the International Market manuals.

The Hardware Management manual is intended for experienced UNIX system administrators who manage hardware components and storage devices.

The Security manual has been split into two separate books:

• Security Administration describes administrative tasks used to manage and monitor the security of your system.

• Security Programming contains the information that was in the Programmer's Guide to Security section of the original Security manual and the GSS API Overview and Tutorial information currently in the Single Sign On Application Security SDK manual.

The information previously contained in Writing Software for the International Market is now contained in two manuals:

• Using International Software describes how to use internationalized software and how to set up and use UDC databases and the Chinese Phrase Input Method.

• Writing Software for the International Market contains information programmers need to create applications for a non-English language environment: message catalogs, curses routines, internationalized Motif applications, and locales.

8.3    Netscape Problem with the Search by Keyword Feature

Netscape on Tru64 UNIX does not handle JavaScript forms correctly. When you use the Reference Pages Search by Keyword feature on the Documentation CD-ROM, the search can fail.

To work around the problem, click in any other window and return to the search window.

This problem does not occur with Netscape or Microsoft Internet Explorer on a Windows PC or Macintosh.

8.4    AltaVista CD-ROM Search Might Not Work Correctly with Netscape Communicator

When the Tru64 UNIX Documentation CD-ROM is used on a PC for which Internet Explorer is the default browser, the CD-ROM search capability works as documented in the instructions window. This window automatically pops up when you click on the Search button that is available from the main page of the documentation library. The instructions tell you to open Windows Explorer, double-click on the icon for the CD-ROM drive, and then double-click on search.exe, which automatically loads the search query entry form into the Internet Explorer window.

When the documentation CD-ROM is used on a PC for which Netscape Communicator is the default browser, these instructions might work, but sometimes do not. Problems observed when trying to use AltaVista CD-ROM Search with Netscape Communicator (Version 4.5 or higher) include the following:

• An attempt to load the search query entry form (InitPage.html) results in a "browser not found" error.

• The search query entry form comes up in a window different from the Netscape browser window.

• If the search query entry form does come up in the Netscape browser window, the first search query consistently hangs.

If you encounter one or more of these problems, use the following procedure to work around them:

1. After launching the AltaVista Search Dispatcher (search.exe), invoke Netscape manually if it is not already running.

2. Use the File Open option in the Netscape window to find and open the InitPage.html file on the CD-ROM drive. Alternatively, you can type the URL to this file in the Netscape browser's Location: field.

3. If your first search query takes more than 30 seconds to execute, click on the Stop icon and re-enter the query.

8.5    Online Help

The following notes apply to the online help.

8.5.1    SysMan Menu

The notes in this section apply to the online help for the SysMan Menu application.

8.5.1.1    Title Bar Is Incorrect

When you use the SysMan Menu's online help in the Common Desktop Environment (CDE), the title bar for the help window always displays the name of the first application for which you requested help.

Ignore the title bar. The correct help volume is displayed in the help window and the Volume label at the top of the window correctly identifies the help volume.

8.5.1.2    Help on Item Sometimes Fails

The SysMan Menu's Help On Item buttons provide online help for the selected menu item. When running the SysMan Menu from a PC, from a web browser, or from the SysMan Station, Help On Item for certain tasks fails with an error when trying to access a URL such as the following:

http://your_machine:2301/SYSMAN/suitlet_help/html/en_US.ISO-8859-1/help_application/help_task.html

To avoid this problem, launch the specific task and select the online help within the task itself. You can also run the SysMan Menu on a terminal or on an X11 display (for example, sysman -display host:0.0) and the help is displayed properly.

8.5.2    SysMan Station

The notes in this section apply to the online help for the SysMan Station (SMS).

8.5.2.1    Online Help Window Does Not Maximize Automatically

If you open an SMS online help window and minimize it, it does not automatically maximize when you reselect Help from the SMS session. You must manually maximize the Help window to view the new help information.

8.5.3    Reference Pages

The following note describes a known problem with the reference pages.

8.5.3.1    Examples Missing New Lines in add_proplist_entry(3) and clu_info(3)

A conversion filter erroneously replaced \n" with 0" or 0 in several examples in these reference pages.

The following shows the incorrect line of code followed by the correct line of code:

add_proplist_entry(3):
  printf("ret %d != buffer_size %d0", ret, buffer_size);
  printf("ret %d != buffer_size %d\n", ret, buffer_size);
 
clu_info(3):
  fprintf(stderr, "clu_get_info error0);
  fprintf(stderr, "clu_get_info error\n");
 
  printf("member hostname is %s0, clugenptr->memblist[i].hostname);
  printf("member hostname is %s\n", clugenptr->memblist[i].hostname);
 
  fprintf(stderr, "Error! Return code of %d0, errno);
  fprintf(stderr, "Error! Return code of %d\n", errno);
 
  printf("Member cluster version is %s0, membinfo->clu_version);
  printf("Member cluster version is %s\n", membinfo->clu_version);