Glossary

Online help for a particular application (software).

A hyperlink designed especially for invoking some application behavior. To invoke the behavior, the help must be displayed in dialogs created by the application. (Application-defined hyperlinks are ignored by Helpview.)

Help presented by the syste as the result of a particular condition or error. Sometimes called "syste initiated" help. For example, error dialogs are a for of "automatic help." See also semi-automatic help and manual help.

The desktop uses the Helpview program as a "help browser" by displaying a special indexvolume that lists the help installed on the system. A utility called dthelpgen creates this volume in the user's home directory.

A warning to the user about possible loss of data. See also note and warning.

An application function called when a help dialog box is closed.

Online information that is relevant to what the user is doing within an application. Sometimes, pressing the F1 key is referred to as "context-sensitive help" because the choice of help topic is based on the user's context.

A hyperlink that jumps to a topic in a different help volume. Cross-volume hyperlinks are entered using the Link element, where the Linkend attribute specifies the ID of the element that is being linked to:

<link lnkend="some-id"></link>

A list of help dialogs that has been created but may not be in use. When the application needs a new help dialog, it first searches its dialog cache for an unused dialog. If one is found, it is used. Otherwise, all dialogs are in use, so a new one is created.

A description of a set of elements used to create a structured (or hierarchical) information. The Document Type Definition (DTD) specifies the syntax for each element and governs how and where elements can be used in a document.

A logical portion of information, such as a book title, a paragraph, a list, or a topic. Normally, the extent of an element is marked by tags, although the tags for some elements are assumed by context.

An element of text that calls attention to the text (usually by being formatted as italic).

A text string or file with a name. Most entities are named by the author (using the <!Entity> element), but some entities are predefined. See also entity declaration and entity reference.

Markup that establishes an entity name and its value. See also entity and entity reference.

Use of an entity name preceded by an & (ampersand) and followed by a; (semicolon) that indicates to DocBook that the entity is to be inserted where the entity name appears. See also entity and entity declaration.

A point within a help volume that may be displayed directly as the result of a request for help. That is, a topic where the user may "enter" or begin reading online help. Any topic, or location within a topic, that has an ID can become an entry point.

A body of text in which line breaks are left as they are and which is displayed in a computer font. The text is typically an example of a portion of a computer file.

A resource that assigns a name to a command string or script that an execution link executes.

A hyperlink that executes a shell command or script. In DocBook, the OLink element is the mechanism for this.

The Help Syste provides a resource that can be set to control the behavior of execution links. This enables a syste administrator or user to establish an appropriate level of security for any given application.

A graphic or illustration that appears in the help information.

A tag set and accompanying usage rules that are specified in the DocBook 2.2.1 Document Type Defnition (DTD). By following the rules set forth in the DTD, an author can produce Standard Generalized Markup Language (SGML) compliant help source files.

A window in which help information is displayed. General help dialog boxes have a menu bar, a topic tree (which provides a list of topics), and a help topic display area. See also quick help dialogbox.

An application function called when the user presses the F1 key.

A set of help volumes that are related to one another because the applications they refer to are related.

A designated key, usually the F1 function key, used to request help on the current context. Some keyboards have a dedicated Help key that may take the place of F1. In Motif applications, the help key is enabled by adding a help callback to a widget.

Help information about how to use the help dialog boxes. The user gets this information by pressing F1 while using a help window, or by choosing Using Help fro the Help menu in a general help dialog box.

A complete body of information about a subject. Also, this ter can refer to either the set of source files that contain the marked-up text or the run-time files generated by running DocBook.

A dialog box that shows a list of the sequence of topics the user has visited. The history sequence can be traversed in reverse order to make it easy for the user to return to earlier topics.

A segment of text (word or phrase) or graphic image that has some behavior associated with it. The most common type of hyperlink is a "jump" link, which connects to a related topic. When the user chooses a jump link, the related topic is displayed. Hyperlinks can also be used to invoke other kinds of behavior, such as executing a syste command or invoking specific application behavior.

An application function that is invoked when a user chooses a hyperlink. This function is responsible for handling the types of hyperlinks not handled automatically within the help dialog.

A list of important words and phrases that appear throughout a help volume. The index is an alphabetical list of the words or phrases that can be searched to find help on a subject. The Help Syste displays the index when the user chooses the Index button (in a general help dialog box). See also Index Search dialog box.

A dialog box that shows a list of index entries for a help volume. An index can be displayed for the current volume, selected volumes, or all help volumes. A user can search the index for a word or phrase and any corresponding topics that contain the search string will be listed.

A small graphic (illustration) that appears within a line of text.

A hyperlink that, when chosen, displays its information in a new dialog box. Jump-new-view links are intended for cross-volume links. The user senses a "new context" by a new window being displayed.

A hyperlink that, if activated, displays a "man page," which is a brief online explanation of a system command. The information in man pages are not supplied through the DocBook system.

A style of online help that requires the user to know what help is needed and how to get it. For example, most commands in a Help menu are considered "manual" help because the user chooses when and what to view. See also automatic help and semi-automatic help.

A message to the user that draws attention to important information. If the information is critically important, a caution or warning is used instead. See also caution and warning.

The portion of the DocBook software that reads the source files (which are created by the author) and converts the into run-time help files that the Help Syste dialogs can read. If the author uses markup incorrectly (or incompletely), the parser detects the problems and indicates that "parser errors" have occurred.

A streamlined help dialog box that has a help topic display area and one or more push buttons. See also general help dialog box, which offers additional capabilities.

The process of declaring a help volume to be accessible for browsing or cross- volume linking.

The files generated by the dtdocbook command. These are the files distributed to users who will use the Help System.

A dialog box that lists the help volumes available on a user's system. When a user chooses Selected fro the Index Search dialog box, this dialog box lists help volumes that the user can select. One or more volume names can be selected and the corresponding index information is reported in the Index Search dialog box.

A style of online help in which the user requests help and the system decides, based on the current circumstances, which help information to display. "Context-sensitive" help (pressing the F1 key) is an example of semi-automatic help. See also automatic help and manual help.

Help information intended to be used independently of application software. For example, online help that explains the basics of computer programming may not be associated with a particular application. A standalone help volume can be displayed using the dthelpview command.

An international standard [ISO 8879: 1986] that establishes a method for information interchange. SGML prescribes constructs for marking the structure of information separate fro its intended presentation or format. The DocBook markup language conforms to this SGML standard.

A text string that marks the beginning or end of an element. A start tag consists of a < (left angle bracket) followed by a special character string (consisting of only letters), optional attributes and values, and terminated by a > (right angle bracket).

An end tag consists of a < (left angle bracket), a / (forward slash), the same special character string, and a > (right angle bracket).

A standard graphics file format. The Help Syste dialog boxes support TIFF 5.0 images. TIFF images are identified by the .tif file-name extension.

Information about a specific subject. Usually, this is approximately one screenful of information. Online help topics are linked to one another through hyperlinks.

A help volume's branching structure in which the home topic branches out (through hyperlinks) to progressively more detailed topics. See also home topic.

In a general help dialog box, a list of topics that can be selected to display help information.

Information that warns the user about possible injury or unrecoverable loss of data. See also caution and note.

The fundamental building block of graphical user interfaces. The Motif widget set provides widgets of all sorts, suitable for constructing an application user interface.

A two-tone image that has one foreground color and one background color. Bitmap image files are identified by the.bm file-name extension.

A multicolor image. Pixmap image files are identified by the .pm file-name extension.

An image captured from an X Window System display. The xwd utility is used to capture a window image. X window dump image files are identified by the .xwd file-name extension.