[GNC] Problems upgrading to 4.8a

Geert Janssens geert.gnucash at kobaltwit.be
Tue Sep 6 08:10:03 EDT 2022


Op dinsdag 6 september 2022 06:01:00 CEST schreef john:
> > On Sep 5, 2022, at 2:01 PM, Frank H. Ellenberger
> > <frank.h.ellenberger at gmail.com> wrote:
> > 
> > Hi,
> > 
> > Am 05.09.22 um 22:27 schrieb Geert Janssens:
> >> Op maandag 5 september 2022 19:09:06 CEST schreef john:
> >>> This is https://bugs.gnucash.org/show_bug.cgi?id=798612
> >>> 
> >>> I discovered while researching this that yelp v.42 just dropped support
> >>> for
> >>> the ghelp: scheme. help:gnucash-help and help:gnucash-guide are able to
> >>> find the GnuCash docs
> >> 
> >> I'm surprised the help: scheme finds the documentation in the old ghelp
> >> locations, but that's good news really.
> >> I think we best add this in for gnucash 4.12 then, and conditional on the
> >> yelp version.
> > 
> > Why conditional, IIRC help: is defined in yelp for about a decade.
> 
> Because yelp v3.x (and maybe v40 and v41, I didn't have those handy to test)
> can't find the GnuCash docs in /usr/share/docs/gnucash-docs with help: so
> we have to use ghelp: on distros that are still shipping older versions of
> yelp.
> 
The intention is correct however the message is slightly confusing with respect to the 
directories involved.
Officially "ghelp:" looks for documentation books in
/usr/share/gnome/help/<document-name>/<language>/
"help:" on the other hand will look for books in
/usr/share/help/<language>/<document-name>/
In both cases we provide the documentation in docbook format (albeit "help:" has a new 
requirement for the name of the initial page to load - it has to be index.docbook for our 
purpose).

The document Phil pointed at in
/usr/share/docs/gnucash-docs(-lang?)/ is where our build scripts will store the html target. 
This has never been used by yelp.


Now to confirm what John said, versions of yelp before v42 (I tested on v41 just now) won't 
search for our documents in
/usr/share/gnome/help/<document-name>/<language>/
when you use the "help:" schema. They will only look in
/usr/share/help/<language>/<document-name>/
It was news to me that yelp v42 does look in both directories (I currently don't have a distro 
installed with the version of yelp).

I agreed with John's suggestion to make the choice conditional on the yelp version as this 
entails the least amount of work. But backporting the whole of my xdg branch to maint is 
certainly possible as well. I don't think there are supported versions of yelp on any distro we 
care about that doesn't know the "help:" schema.

Regards,

Geert


More information about the gnucash-user mailing list