[GNC] Problems upgrading to 4.8a

[David Cousens]

Hi Geert 

GnuCash 4.11 on Linux Mint Vanessa (Ubuntu 22.04 based) also gives the same
error 
"Document Not Found
The URI ‘ghelp:gnucash-guide’ does not point to a valid page." 
when opening the tutorial or help manual from the menu.

There are no gnucash doc files for yelp in /usr/share/gnome/help
and only the html files in /usr/share/doc/gnucash-docs/.

This probably indicates the Ubuntu developers haven't solved the problem.

I loaded the help fiels from the LM Software Manager. I also have the tarball
downloaded so I will try compiling it and experiment a bit when I get a bit of
spare time.

David Cousens

On Mon, 2022-09-05 at 18:03 +0200, Geert Janssens wrote:
> Hi Phil,
> 
> My response was not for flatpak. It's how the gnucash-docs build scripts
> (written by the 
> gnucash developers) currently install things. And on Fedora 36 for example
> that is still the 
> case.
> 
> The documentation links you are listing are the html versions of our
> documentation and is 
> not what is presented when invoking "Tutorial" or "Contents" from the GnuCash
> menus. 
> GnuCash will look for the docbook version of the documentation, which at this
> point is still 
> installed in /usr/share/gnome/help/C/gnucash-guide and
> /usr/shar/gnome/help/C/gnucash-
> help. (Well, pedantically it will ask yelp to look there by means of the
> "ghelp:xyz" construct, 
> but yelp dropped support for that construct in version 42).
> 
> I don't know what the Ubuntu packager for our documentation has decided on.
> But if 
> Ubuntu only ships the html version of the gnucash documentation, I consider
> that a bug in 
> that distribution. There are a few possible ways the Ubuntu packager could
> solve this:
> * either also patch the gnucash package to look for the html version of the
> documentation
> * revert the change in yelp that drops support for the "ghelp" search
> qualifier. Considering 
> gnucash is probably the last application in the Gnome ecosystem to still
> depend on this, it's 
> unlikely Ubuntu would go that route.
> * backport the patchset from the master branch in the gnucash and gnucash-docs
> repositories that rearrange our documentation output to work with yelp's
> "help" search 
> qualifier. That way gnucash will be able to present the documentation again as
> you were 
> used to in Ubuntu 20.04.
> 
> I think the last option would be the most future proof one.
> 
> Regards,
> 
> Geert
> 
> 
> Op maandag 5 september 2022 17:01:22 CEST schreef Phil Wolff via gnucash-user:
> > Geert ~
> > 
> > Thanks for responding!
> > That may be true for a Flatpak installation, but mine is what GNC calls
> > "pristine," and I've found the documents at
> > - file:///usr/share/doc/gnucash-docs/gnucash-guide-en/index.html
> > - file:///usr/share/doc/gnucash-docs/gnucash-help-en/help.html
> > 
> > ~ Phil
> > 
> > On 9/5/22 00:46, Geert Janssens wrote:
> > > Hi Phil,
> > > 
> > > Regarding the documentation, it seems like Ubuntu 22.04.1 ships a newer
> > > help viewer that's not compatible with where GnuCash stores its guide and
> > > manual on disk. This has been fixed for the future GnuCash 5.0 but not
> > > for the current 4.x series.
> > > 
> > > As temporary workarounds you could either
> > > - browse the documentation online (via the gnucash website) or
> > > - load the documentation from the command line using one of these commands
> > > 
> > >    yelp /usr/share/gnome/help/C/gnucash-guide/gnucash-guide.xml
> > >    yelp /usr/share/gnome/help/C/gnucash-help/gnucash-help.xml
> > > 
> > > Regards,
> > > 
> > > Geert
> > > 
> > > Op zondag 4 september 2022 00:14:09 CEST schreef David Cousens:
> > > > Phil,
> > > > 
> > > > The installation of the GnuCash help and Tutorial and concepts guide is
> > > > a
> > > > separate download and installation from the installation of the program
> > > > and
> > > > is available under a separate link in the panels on the left on the
> > > > GNuCash
> > > > webpage i.e. https://gnucash.org/docs.phtml .  They should also be able
> > > > to
> _______________________________________________
> gnucash-user mailing list
> gnucash-user at 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.