Usually you wouldn't use those gnome.help.* functions.  This is how the
GNOME help system is used.

First generate your help files in HTML (maybe translated from SGML or
latex, maybe hand coded).  You should put this documentation in
$(gnome_prefix)/share/gnome/help/$(package)/$(lang)/.  You should also
have some documentation in a directory for lang=C.

In the directory, along with the HTML, put a file called topic.dat.  It
contains lines of the form
<relative-url> <title>

So for instance, gnumeric's topic.dat file looks like this:
gnumeric.html   Gnumeric manual 
function-reference.html Gnumeric Functions reference

And my program gnorpm's looks like this:
gnorpm.html#Top         Introduction
gnorpm.html#MainWin     The main window
gnorpm.html#InstallWin  The install window
gnorpm.html#QueryWin    The query window
gnorpm.html#FindWin     The find window
gnorpm.html#RpmFind     The web find window


Next, in your program, it is good if you have used UIInfo structures to
build the menus (like in the examples in pygnome/examples).  The help menu
uiinfo structure will probably look like this:
  [ UIINFO_ITEM_STOCK('About...', None, about_cb, STOCK_MENU_ABOUT),
    UIINFO_SEPARATOR,
    UIINFO_HELP('package-name'),
    UIINFO_END ]

Where package-name matches the help directory you created.  This will add
an entry to the help menu for each line in topic.dat, which display the
help file associated with the entry.

With this system, it is pretty easy to setup localised help for your
program.

James Henstridge.

--
Email: [EMAIL PROTECTED]
WWW:   http://www.daa.com.au/~james/


On Tue, 2 Mar 1999 [EMAIL PROTECTED] wrote:

> 
> Does somebody has a simple of how to use help in gnome. 
> I see all the function are in help.py but I can't figure out how to call
> them.
> 
>               Thanks
> 
> 
>                               Daniel Kornhauser
> 
> To unsubscribe: echo "unsubscribe" | mail [EMAIL PROTECTED]
> 

To unsubscribe: echo "unsubscribe" | mail [EMAIL PROTECTED]

Reply via email to