ONLINE_HELP procedure invokes the hypertext help viewer. If called with no arguments, it simply starts the help viewer with the default IDL help file displayed. Optionally, a different book, a
keyword search string, or a context number can be specified. Note that this procedure is intended for use in user-written routines. To invoke IDL's online help from the command line, it is much simpler to use the
An optional string that contains text to be searched for using the viewer's "keyword search" (not full-text search) facility. If this argument is omitted, the specified or default book is displayed at its beginning.
Set this keyword to a string containing the name of the online help "book" to be displayed. If this keyword is omitted, the default IDL help file is displayed. Any file specified by this keyword must be in the appropriate format for the viewer being invoked (e.g., on Windows, the file must be a Windows
help file; on Unix, it must be a HyperHelp
By default, this string should be the name of a file found in the default location for IDL's online help files (i.e., wherever the file
without a path or file extension
. However, if the FULL_PATH keyword is set, this string should be a complete path and filename to the online help file you wish to display.
Set this keyword to indicate that the Topic argument is an integer value that represents the context number of the help topic to be displayed. This keyword is intended for use with user-compiled help files that contain topics that have been mapped to specific context numbers when they were compiled (using the [MAP] section of the help project file). Specifying a non-existent context number causes the first topic of the requested help file to be displayed.
The help files shipped with IDL do not contain explicit context number mappings. Therefore, the context numbers of specific topics are undocumented, unknown, and subject to change between releases of the help system.