Patch-ID# 100617-01 Keywords: Ada, XView, xview, binding Synopsis: SunAda 1.1: Improvement in Sun Ada XView bindings Date: 7-May-92 ******************************************************************************** PLEASE read the ENTIRE installation discussion before proceeding with the installation of this patch. ******************************************************************************** SunOS release: 4.1.x Unbundled Product: Sun Ada Unbundled Release: 1.1 Topic: Patch for XView bindings BugId's fixed with this patch: 1087181 1087181 Help feature doesn't work Architectures for which this patch is available: sun4, sun4c Patches which may conflict with this patch: none Obsoleted by: Problem Description: Support for XV_HELP_DATA was missing from the XView bindings; this patch corrects that. There is a corresponding patch to GXV-Ada, patch-ID 100616-01, since the 1.1 GXV-Ada is not compatible with this patch. Change to the XView Interface that WILL require a code change -------------------------------------------------------------- To use XV_HELP_DATA, you will need to change your code to look like this: draw := xvi_av_functions.xv_create(panel, xvi_xview.PANEL_BUTTON, ((xvi_panel.PANEL_LABEL_STRING, svi_strings.svi_str("Draw")), (xvi_panel.XV_HELP_DATA, convert_val(xvi_panel.XV_HELP), convert_val("button.draw")), (attr => xvi_panel.PANEL_NO_ATTR))); The above code fragment is extracted from $SUNADAHOME/examples/xview_examples/buttons.a, which is included with this patch. INSTALL: In the simple install sequence below, refers to the root of the directory tree that holds the files of SunAda. This directory is usually "pointed to", at least during SunAda use, by the environment variable SUNADAHOME. refers to the root of the directory tree that holds the files of this patch. To install this patch, you must become the owner of the Sun Ada release (usually root) and go to the directory where you installed Sun Ada: % su root # cd # cp -r /* # % then modify the ADAPATH and LINK directives in the xview library to conform to your installation. You will need to edit xview_v2/ada.lib and xview_v3/ada.lib LINK directives to reflect your OPENWINHOME path names for OWv2 and OWv3, respectively. Note: It is necessary to set the environment variable HELPPATH correctly, in order to use XV_HELP_DATA; for example: setenv HELPPATH .:$GUIDEHOME/lib/locale:$GUIDEHOME/lib/help would cause the system to search for on-line help in your current working directory first, and then in your DevGuide installation directory.