There is one main limitation for libhelp URLs (Uniform Resource Locator). Libhelp only supports hypertext references to files. You can't follow WWW (World Wide Web) links that point to sites on the net with the libhelp browser. (Of course, you can use any HTML browser to read the help documents written for libhelp too).
Therefore libhelp URLs are limitated to local file references with optional anchors like
"[file:]<filename>[#<anchorname>]"
.
For example, to reference the help text in the file
"example.html
" (somewhere in the libhelp search path) and start
displaying sections under the anchor "Example
", you
would specify the URL "example.html#Example"
like
get_help (toplevel, "example.html#Example", NULL);
in your application, or
<A HREF="example.html#Example">Example</A>
in another help file.
Relative filename specifications are relative to directories in the libhelp search path. Implicitely, the directory where the current document is loaded from, is always member of the set of search directories with the highest priority.
Absolute filename specifiactions (those beginning with "." or "/") are possible, but should be avoided in help systems, because your helpfiles must be at the same place in all installations and cannot easily move.