New Ticket     Wiki     Browse Source     Timeline     Roadmap     Ticket Reports     Search

Ticket #11903 (closed defect: fixed)

Opened 5 years ago

Last modified 3 years ago

BUG: Gnucash Docs don't work -yelp problem

Reported by: ben.miller@… Owned by: rhwood@…
Priority: Normal Milestone:
Component: ports Version:
Keywords: gnome gnucash Cc: rhwood@…
Port:

Description

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)

Attachments

firefox-x11.tgz Download (2.8 KB) - added by mta@… 4 years ago.
Upgraded firefox-x11 port
yelp.tgz Download (1.2 KB) - added by mta@… 4 years ago.
Upgraded yelp port
libxml2.patch Download (1.4 KB) - added by mta@… 4 years ago.
Patch to upgrade libxml2 port
libxslt.patch Download (1.3 KB) - added by mta@… 4 years ago.
Patch to upgrade libxslt port

Change History

Changed 5 years ago by mas@…

  • cc mas@… added
  • keywords gnome gnucash added
  • version set to 1.4.3
  • component changed from doc to ports
  • milestone set to Port Bugs

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!

Changed 5 years ago by markd@…

  • summary changed from Gnucash Docs doesn't work to BUG: Gnucash Docs don't work -yelp problem

Changed 5 years ago by mas@…

  • cc mas@… added; mas@… removed

Changed 4 years ago by mta@…

Upgraded firefox-x11 port

Changed 4 years ago by mta@…

Upgraded yelp port

Changed 4 years ago by mta@…

Patch to upgrade libxml2 port

Changed 4 years ago by mta@…

Patch to upgrade libxslt port

Changed 4 years ago by 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.

Changed 4 years ago by rhwood@…

  • cc rhwood@… added; mas@… removed
  • status changed from new to assigned
  • owner changed from macports-dev@… to rhwood@…

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

Changed 4 years ago by rhwood@…

  • priority changed from Expected to Normal
  • version 1.4.3 deleted

firefox-x11 upgrade committed in changeset:28578

Changed 4 years ago by 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

Changed 4 years ago by rhwood@…

  • status changed from assigned to closed
  • resolution set to fixed

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

Changed 3 years ago by anonymous

  • milestone Port Bugs deleted

Milestone Port Bugs deleted

Note: See TracTickets for help on using tickets.