help not working

[Alex Aycinena]

Geert,

> ---------- Forwarded message ----------
> From: Geert Janssens <janssens-geert at telenet.be>
> To: gnucash-devel at gnucash.org
> Cc:
> Date: Tue, 25 Sep 2012 10:24:33 +0200
> Subject: Re: help not working
> On 25-09-12 00:05, Alex Aycinena wrote:
>>
>> With the latest build of trunk and docs, when I try to bring up the
>> help manual or the tutorial I get a message as follows:
>>
>> "The URI 'ghelp:gnucash-help' does not point to a valid page."
>>
>> Has anyone made a change recently that might have caused this to no longer work?
>>
>> Regards,
>>
>> Alex
>>
> Hi Alex,
>
> That would probably me (again), with revision 22378:
> "Show help and guide in gnome independent way"

Yes I reverted to 22377 and it worked like before, then when I updated
to 22378 it failed as described above.

>
> This was done to drop the dependency on libgnome. I took the alternative way of showing help from the planner application. It works fine on Fedora but may require modifications to the way the documentation is installed. That's also the main reason I want to do a documentation release soon.
>
> There are several aspects that lead to this change:
> - I wanted to drop the dependency on libgnome and the old way of loading the help file depended on libgnome
> - I found an alternative way to show help in the planner application (also a gtk application), using gtk_show_uri ("ghelp:gnucash_help").
> - This did launch yelp on my Fedora system, but the help file wasn't found
> - Some research brought me to gnucash bug 688705 [1] which suggested that the help files were installed in the wrong location to work properly.
> - So I made some fixes to the documentation tree as well to fix the install locations.
>
> Those things together fixed all the issues on Fedora (where I'm using kde as my desktop environment).
>
> I'm curious to know what is different in your environment.
>
> What is your OS/platform again ?

I use Fedora as you do.

> Does the help command start yelp and do you get the error message in yelp ?

Yes, yelp is started and it is within yelp that the message quoted
above is shown. There is a link "Search for packages containing this
document." and when I click on it, a dialog opens asking for an OK to
install files 'index.page' and 'gnucash-help.xml' in
'/usr/local/share/gnome/help/gnucash-help/C/' and in
'/usr/share/gnome/help/gnucash-helpC/'. Different from both of these,
the Fedora package manager seems to have gnucash 2.4 documentation
installed in '/usr/share/gnome/help/gnucash/C/'. But in this case, I
want the help that I've installed myself from trunk in
'/opt/gnucash-svn/gnucash-clean/share/gnome/help'. Under this
directory there are two subdirectories: gnucash-guide, and
gnucash-help. I also install documentation that I am working on in
'/opt/gnucash-svn/gnucash-working/share/gnome/help', so that depending
on whether I am calling help from a version of gnucash installed in
trunk 'clean' or from a version installed in trunk 'working', I should
get different versions. This is the way it always worked before.

>
> Geert
>
> [1] https://bugzilla.gnome.org/show_bug.cgi?id=661705
>

Regards,

Alex