TECHNICAL INFORMATION DOCUMENT TITLE: TF2032 - Wksh Interface to On-line Help DATE: 05JUN95 README FOR: TF2032 PRODUCT and VERSION: UnixWare 2.0 Installation Instructions: DATATYPE: datastream 1. Download the tf2032.Z and tf2032.txt files to the /tmp directory on your machine. 2. Read the release notes contained in file and follow the instuctions to add the package to your system. 3. Now become root, uncompress the file and add the package to your system using the following commands: $ su # uncompress /tmp/tf2032.Z # pkgadd -d /tmp/tf2032 ENGINEERING REALEASE NOTES -------------------------- Title ----- PTF2032 - Wksh Interface to On-line Help Product And Version ------------------- UnixWare 2.01, UnixWare 2.02 Abstract -------- Adds a new command, RegisterHelp, to wksh (Motif version) enabling wksh-based applications to identify application-specific help files to be displayed by the Desktop On-line Help Facility. Symptom -------- None - new feature SOLUTION SPECIFICS ------------------ General Description. ------------------- This PTF adds a new command, RegisterHelp, to the Motif-based version of wksh. The RegisterHelp command enables wksh-based applications to identify application-specific help files to be displayed by the Desktop On-line Help Facility. This PTF supercedes PTF2015 and includes the changes that correct errors in the env_get routine of wksh that cause it to return NULL or otherwise invalid pointers when retrieving the value of any variable type other than a "standard" character string variable. Note that depending on the type of variable accessed, the returned pointer may point to a static buffer which will be overwritten on a subsequent call to env_get. New Features. ------------ Adds a new command, RegisterHelp, to the Motif version of wksh. Depending on the command arguments, RegisterHelp can enable an interface that will open either the Desktop Help Desk or an application-specific help file or will display a brief help message. An example of the use of RegisterHelp is provided in the script /usr/X/lib/wksh/xmexamples/helpdemo. Software Notes and Recommendations. ---------------------------------- This PTF can be installed on all UnixWare 2.01 or 2.02 systems which have the Desktop Manager (desktop) package installed. Installing Update 2.02 has no effect on this PTF, so no additional steps are necessary to restore this PTF after Update 2.02 has been installed. Testing of the modified software contained in this package has been conducted only to the extent necessary to confirm that it resolves the problem(s) stated above ("Symptom"). Such testing consists of recreating the problem conditions and verifying that the problem no longer occurs. No other testing of this software has been done. Hardware Notes and Recommendations. ---------------------------------- This PTF is targeted for the i386, i486 and Pentium CPU's.