Op dinsdag 6 september 2022 06:01:00 CEST schreef john: > > On Sep 5, 2022, at 2:01 PM, Frank H. Ellenberger > > <frank.h.ellenber...@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 _______________________________________________ gnucash-user mailing list gnucash-user@gnucash.org To update your subscription preferences or to unsubscribe: https://lists.gnucash.org/mailman/listinfo/gnucash-user ----- Please remember to CC this list on all your replies. You can do this by using Reply-To-List or Reply-All.
