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:
After launching the AltaVista Search Dispatcher (search.exe
), invoke Netscape manually if it is not already running.
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.
If your first search query takes more than 30 seconds to execute, click on the Stop icon and re-enter the query.
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);