BUG: Gnucash Docs don't work -yelp problem

[ben.miller@…]

Gnucash docs doen't work. Clicking the help icon in GnuCash (2.0.5) (under X11) gives an error message that Gnucash Docs are not installed although they are installed (GnuCash Docs 2.0.1_0)

[mas@…]

I know it does not work -- I have not yet been able to find out exactly why. It appears that this is a bug in yelp, the Gnome help browser.

You can check the installation by invoking yelp yourself: open-x11 yelp. Then browse to Applications and try to open any of the DocBook docs: "There is no default action associated with this location."

As a workaround, the gnucash-docs port installs a HTML copy of all documentation, which can be found in ${prefix}/share/doc/gnucash/index.html

yelp does not have a maintainer. If you can provide a patch to make things work, that would be most welcome!

[mta@…]

Upgraded firefox-x11 port

[mta@…]

Upgraded yelp port

[mta@…]

Patch to upgrade libxml2 port

[mta@…]

Patch to upgrade libxslt port

[mta@…]

I got a newer version of yelp (2.18.1) to work in MacPorts. As noted elsewhere this required getting the firefox-x11 port to work too. It was old, and didn't work anyway, so I updated it to version 2.0.0.6. Note that I only updated yelp to 2.18.1, not to the more recent 2.19 development series since the later versions may not work well and replace scrollkeeper with rarian. Porting everything to that is more than I wanted to get into. This means that gnome-doc-utils must not be updated past version 0.10.3 since the 2.18 versions of yelp are not compatible with later versions of gnome-doc-utils.

Getting this to work right was a bit tricky since the makefiles that produce a number of the FireFox shared libraries don't know where the libraries will ultimately be installed. This means that they can't set the -install_name parameter for the linker correctly. Instead they use the @executable_path prefix on the install name which makes the installed path relative to the location of the program loading the shared library. The net effect is that any program that uses the gecko renderer from FireFox must be installed in the same directory as FireFox. The yelp port moves the binary into the appropriate place and replaces it with a symlink. I don't know if I found the "appropriate place" correctly. It works but I may be using unpublished interfaces that port files aren't supposed to use.

There were also some bugs in both yelp and firefox that made them not build or work correctly in MacOSX. The bugs in FireFox seem to imply that this version has never built and run on MacOSX (with or without MacPorts). The bug in yelp may not matter, I found it by inspecting debug output and haven't verified that it really affects things all that much.

In the process of figuring out why yelp didn't work I also updated the ports for libxml2 and libxslt. Both of these were easy to update, and the updates may or may not be needed for yelp to work.

I also added a +debug variant to most of these ports. I find this useful, but if others think it is a bad idea remove it before committing these changes.

I've attached patch files for the libxml2 and libxslt upgrades. For firefox-x11 and yelp I've attached an archive of the port since the changes involve adding and removing patch files.

[rhwood@…]

I am testing the firefox-x11 port and have upgraded libxslt

[rhwood@…]

firefox-x11 upgrade committed in changeset:28578

[rhwood@…]

yelp upgrade commited in changeset:28596

I really do not like the voodoo we are engaging in post-destroot, but am accepting it for now

[rhwood@…]

libxml2 updated in changeset:28765 with the permission of the maintainer At this point all patches have been applied

[anonymous]

Milestone Port Bugs deleted