Re: Rarian and Yelp

[Don Scorgie <Don Scorgie org>]

Requested update...

On Fri, 2007-08-03 at 19:21 -0400, Joe Marcus Clarke wrote:
> On Fri, 2007-08-03 at 18:53 +0100, Don Scorgie wrote:
> 
> > > Yes, this appears to be working fine.  What happens is rarian goes
> > > through each of the omf subdirectories, and adds an entry with a ghelp
> > > name of the subdirectory name (dp->d_name).  So, if my omf subdirectory
> > > contains:
> > > 
> > > eog     gnome-terminal
> > > 
> > > I get two rarian doc entries with ghelp names of "eog" and "gnome-termial".
> > 
> > So, rarian-example prints out the entries properly?  Or are you watching
> > the list get built in Rarian itself? [1]
> 
> I hacked rarian to print out a line for every .omf file it found and its
> associated ghelp name.

I fixed Rarian to correctly handle this as of latest SVN.

> 
> 
> > > I've done some more research here, and I found that when I launch yelp
> > > via another app (e.g. eog) it is passed a ghelp URI in the format (via
> > > libgnome):
> > > 
> > > ghelp:///usr/local/share/gnome/help/eog/C/eog.xml
> > > 
> > > Yelp breaks this down to "///usr/local/share/gnome/help/eog/C/eog.xml"
> > > and passes that to rarian.  Rarian fails to find any documents since all
> > > of its ghelp names are just the appid.
> > > 
> > > Since our libgnome is fairly stock, I'm really not sure how this mapping
> > > works successfully on Linux.
> > 
> > Okay, that's a failure of the new resolver.  It should check the ghelp
> > uri to see if it's a full path before invoking rarian.  I'll fix that
> > soon.
> 
> Excellent!  Thanks.

This has now been fixed in latest SVN.

<etc.>

Don

> 
> I'll look forward to an update.  I'll also file a bug with my FreeBSD
> port fixes  Thanks for your help.
> 
> Joe
>