<HTML>
<HEAD>
<!-- Some simple instructions on how to use the help browser -->
<TITLE> GNOME Help Browser Documentation</TITLE>
</HEAD>
<BODY BACKGROUND="bg.png">
<a name="Top">
<H2> GNOME Help Browser Documentation </H2>

The GNOME Help Browser is an interface to the various forms of
documentation present on your computer, and from other computers
via the Internet. This short document will describe the main
features of the GNOME Help Browser.

<a name="Cmdline">
<h3>Command Line Options</h3>
<ul><pre>
  -d, --debug                Debug level, add more to increase level
  -h HEIGHT                  Height of window
  -w WIDTH                   Width of window
  -x X                       X position of window
  -y Y                       Y position of window
      --display=DISPLAY      X display to use
      --no-xshm              Don't use X shared memory extension
  -?, --help                 Give this help list
      --usage                Give a short usage message
  -V, --version              Print program version
</pre></ul>


<a name="Menus">
<H3> Menus </H3>
There are several menu entries for the GNOME Help Browser located at the
top of the application window. Their behavior should be self-explanatory.

<a name="Toolbar">
<H3> Toolbar </H3>
The toolbar has several buttons to make using the Help Browser much
more convenient. The <b>Next</b> and <b>Prev</b> button cause the
browser to go back and forth through the history of the pages you have
visited during this session. The <b>Help</b> button brings up this help.
The <b>History></b> button brings up a history of the sites you have visited,
and the <b>BMarks</b> button brings up a bookmark listing of sites you've
marked in the past.

<a name="Entry">
<H3> URL Entry Box </H3>
The entry box allows you to enter URL's directly. The Help Browser recognizes
the following standard and 'magic' URL types:
<p>
<dl>
  <dt>http:
   <dd> Access document using HTTP transfer protocol.<br><br>
        Examples are:
     <ul>
         <li> http://www.gnome.org
         <li> http://www.gnome.org/index.shtml
         <li> http://www.gnome.org/index.shtml#majic
     </ul>
   </dd>
  </dt>

  <dt>file:
   <dd> Access file on the local filesystem.<br><br>
        Examples are:
     <ul>
         <li> file:/home/msf/maji12.html
         <li> file:/usr/man/man1/ls.1
         <li> file:/usr/src/gogo/README
     </ul>
   </dd>
  </dt>

  <dt>whatis:
   <dd> Do a subtring search of document names.<br><br>
        Possible forms are:
     <ul>
        <li> whatis:ls
        <li> whatis:xman
     </ul>
   </dd>
  </dt>

  <dt>toc:
   <dd> Load a table of contents of available documents.<br><br>
        Possible forms are:
     <ul>
        <li> toc:
        <li> toc:man
        <li> toc:info
        <li> toc:ghelp
     </ul>
   </dd>
  </dt>

  <dt>man:
   <dd> Load a manual page.<br><br>
        Examples are:
     <ul>
        <li> man:ls
        <li> man:ls(1)
     </ul>
   </dd>
  </dt>

  <dt>info:
   <dd> Load a GNU info page.<br><br>
        Examples are:
     <ul>
        <li> info:emacs
        <li> info:emacs#Top
     </ul>
   </dd>
  </dt>

  <dt>ghelp:
   <dd> Load a GNOME help for an application. <br>
         <b>NOTE</b>:Not much documentation in this format exists 
         currently.<br><br>
         Examples are:
      <ul>
         <li> ghelp:help-browser
      </ul>
   </dd>
  </dt>

</dl>

<a name="Bookmark">
<H3> Bookmark Window </H3>
The bookmark window lists all the bookmarks currently available. To add a
bookmark use the <b>Add Bookmark</b> option under the <b>File</b> menu.

<a name="History">
<H3> History Window</H3>
The history window lists a history of the sites which have been visited
over time.  It has a maximum length configurable under the <b>Settings</b>
menu.

</BODY>
</HTML>
