hyperhelp - Create and manipulate a hyperhelp widget

SYNOPSIS

hyperhelp pathName ?options?
INHERITANCE
itk::Toplevel <- shell <- hyperhelp
STANDARD OPTIONS

activeBackground
exportSelection
insertBackground
insertWidth
repeatDelay
selectForeground
background
foreground
insertBorderWidth
padX
repeatInterval
setGrid
borderWidth
highlightColor
insertOffTime
padY
selectBackground
cursor
highlightThickness
insertOnTime
relief
selectBorderWidth

See the "options" manual entry for details on the standard options.
ASSOCIATED OPTIONS

hscrollmode
fontsize
width
unknownimage
vscrollmode
fixedfont
height
textbackground
link
state
fontname
linkhighlight
wrap

See the "scrolledhtml" widget manual entry for details on the above associated options.
INHERITED OPTIONS

modality
title

See the "shell" manual entry for details on the above inherited options.
WIDGET-SPECIFIC OPTIONS

Name: topics Class: Topics Command-Line Switch: -topics

Specifies a list of help topics in the form {?topic? ... }. Topic may either be a topic name, in which case the document associated with the topic should be in the file helpdir/topic.html, or it may be of the form {name file}. In the latter case, name is displayed in the topic menu, and selecting the name loads file. If file has a relative path, it is assumed to be relative to helpdir.

Name: helpdir Class: Directory Command-Line Switch: -helpdir

Specifies the directory where help files are located.

DESCRIPTION

The hyperhelp command creates a shell window with a pulldown menu showing a list of topics. The topics are displayed by importing a HTML formatted file named helpdir/topic.html. For a list of supported HTML tags, see scrolledhtml(n).
METHODS

The hyperhelp command creates a new Tcl command whose name is pathName. This command may be used to invoke various operations on the widget. It has the following general form:
pathName option ?arg arg ...?
Option and the args determine the exact behavior of the command. The following commands are possible for dialog widgets:
INHERITED METHODS

activate
center
childsite
deactivate

See the "shell" manual entry for details on the above inherited methods.
WIDGET-SPECIFIC METHODS

pathName cget option
Returns the current value of the configuration option given by option. Option may have any of the values accepted by the hyperhelp command.

pathName configure ?option? ?value option value ...?: Query or modify the configuration options of the widget. If no option is specified, returns a list describing all of the available options for pathName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given widget option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the hyperhelp command.

pathName showtopic topic: Display html file helpdir/topic.html. Topic may optionally be of the form topicname#anchorname. In this form, either topicname or anchorname or both may be empty. If topicname is empty, the current topic is assumed. If anchorname is empty, the top of the document is assumed

pathName followlink href: Display html file href. Href may be optionally be of the form filename#anchorname. In this form, either filename or anchorname or both may be empty. If filename is empty, the current document is assumed. If anchorname is empty, the top of the document is assumed.

pathName forward: Display html file one forward in history list, if applicable.

pathName back: Display html file one back in history list, if applicable.

EXAMPLE

 hyperhelp .h -topics { Intro Help } -helpdir ~/help
 .h showtopic Intro

AUTHOR

Kris Raney

KEYWORDS

hyperhelp, html, help, shell, widget