Re: Help suckage for GNOME2

[Mikael Hallendal <micke codefactory se>]

sön 2002-03-03 klockan 20.59 skrev Kevin Vandersloot:

Hi!

Is this inside libgnomeui? I was under the impression that applications
should only add one menu item saying ("Help") or something which should
call gnome_help_display ("ghelp:/usr/share/gnome/help/....");

This should in turn fire up Yelp (with 'yelp ghelp:...').

So why is libgnomeui parsing TOC-files? Or is this in your application?

Obviously I'm a bit confused :)

I'm getting ready to release Yelp 0.3 which has the last outstanding
feature (index searching) implemented. So from now on I can spend time
on debugging Yelp and working together with someone on making things
work together with the GNOME help system.

So, whoever is in charge (if any) of making the things work in
libgnome(ui?), please contact me if I need to make changes in Yelp for
things to work as expected.

Regards,
  Mikael Hallendal

> I opened a bug about this:
> http://bugzilla.gnome.org/show_bug.cgi?id=73312
> 
> First is the help menu items for libgnomeui (gnome-app-helper.c). I came
> across a number of issues before I was able to display something. Here
> goes:
> 
> 1) First is the call to get_toc_location. It seems the call to popen
> wasn't working. I typed the cmd string on a command line and it returned
> the proper file to open yet popen wasn't working. It seems that
> scrollkeeper-get-toc-from-docpath is appending a "\n" to the end of the
> file name. I think this is what is screwing up popen.
> 
> 2) Now in get_topics. The xmlParseFile should be xmlParseDoc since
> get_best_toc_location returns the xml and not the file name.
> 
> 3) This brings up the issues that libgnomui is trying to make an entry
> for every topic - ie, gcalc will get the following entries: 
> Introduction intro 
> Using GNOME Calculator usage 
> Basic usage mainwin 
> Menus menubar 
> Buttons buttons 
> Known Bugs and Limitations bugs 
> Authors authors 
> License license
> 
> This doesn't seem right.
> 
> 4) Now in trying to build an entry for each item, it turns out that the
> xml TOC files don't seem correct at all. They had lots of extra spaces
> in them (probably should just strip the extra white space) and didn't
> seem to have proper begining and ending sections (I don't know the
> proper xml terminology)
> 
> 5) Finally gnome-app-helper.c then calls gnome_help_display which
> doesn't seem to work at all. I changed it to gnome_help_display_desktop,
> but is that the right call to make (that's what Mark did for
> gnome-panel)?
> 
> 
> The second issue for app writes is the fact that gnome_help_display
> doesn't seem to work. I looked into that a while ago and sent a message
> to Jonathan. 
> 
> So I hope this helps something get the help items working. Unfortunately
> I don't know enough of how it is supposed to work to fix it completely.
> 
> Regards,
> Kevin
> 
> 
> _______________________________________________
> desktop-devel-list mailing list
> desktop-devel-list gnome org
> http://mail.gnome.org/mailman/listinfo/desktop-devel-list
-- 
Mikael Hallendal                micke codefactory se
CodeFactory AB                  http://www.codefactory.se/
Office: +46 (0)8 587 583 05     Cell: +46 (0)709 718 918