Dumping the widget sums
To obtain the widget sums for your manager:
Log in as root and set the environment variable
VTCL_HELPTRACE=TRUE; export VTCL_HELPTRACE
If your DISPLAY is not set, set it as well.
You cannot dump widget in character mode; you must run a
Check to see if the SCO Visual Tcl server (xm_vtcld) is running:
ps -ae | grep xm
If it is running, use the process ID (PID)
ps for the kill command:
kill -9 PID
Start your manager.
Press <Ctrl><F1>. This brings up the Help Sums browser
``Help sum browser''.
This tool allows you to traverse the widget tree.
The browser displays:
name of the manager script
name of parent widget
widgets of the current window
Help sum browser
Obtain the top-level sum for the manager. This
will be attached to the default help for your manager. Click on the
Up The Tree button until it becomes dimmed (stippled).
Record the widget sum displayed as the top-level help.
Use cut-and-paste to copy a sum from the text field (not from the
displayed list) to a file.
Always obtain the highest-level widget possible. This ensures
that your help will cover every element on the window. If you
link too low, there is a chance that a window element will have
no help. If the user clicks on the Help
button and you hooked too low into the tree, DocView will
simply default to the top-level help for the manager.
Use the buttons to move up and down the tree.
Unless you want to attach help to a specific
window element (such as a button or field), you should
provide help for each window. Widget names ending in
popup are the top-level sums for windows, as
in this example that corresponds to
the Customize Toolbar window:
outer_custom_popup : A394055104
This sum was obtained by walking up the widget tree several
main appeared in the ``Parent'' heading.
To attach help to an individual window element,
use the cursor to point to it before pressing <Ctrl><F1> again.
If you have trouble figuring out which widget name corresponds to
what window element, pressing <F1>
will send the individual widget to the standard output --
Template widget sums for main window: appGUI (partial list)
Creating context-sensitive help
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003