Opened 17 years ago

Closed 17 years ago

Last modified 15 years ago

#11903 closed defect (fixed)

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@… mas@… ben.miller@… martinr.williams@…
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 (4)

firefox-x11.tgz (2.8 KB) - added by mtalexander (Mike Alexander) 17 years ago.
Upgraded firefox-x11 port
yelp.tgz (1.2 KB) - added by mtalexander (Mike Alexander) 17 years ago.
Upgraded yelp port
libxml2.patch (1.4 KB) - added by mtalexander (Mike Alexander) 17 years ago.
Patch to upgrade libxml2 port
libxslt.patch (1.3 KB) - added by mtalexander (Mike Alexander) 17 years ago.
Patch to upgrade libxslt port

Download all attachments as: .zip

Change History (13)

comment:1 Changed 17 years ago by mas@…

Cc: mas@… added
Component: docports
Keywords: gnome gnucash added
Milestone: Port Bugs
Version: 1.4.3

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!

comment:2 Changed 17 years ago by markd@…

Summary: Gnucash Docs doesn't workBUG: Gnucash Docs don't work -yelp problem

comment:3 Changed 17 years ago by mas@…

Cc: mas@… added; mas@… removed

Changed 17 years ago by mtalexander (Mike Alexander)

Attachment: firefox-x11.tgz added

Upgraded firefox-x11 port

Changed 17 years ago by mtalexander (Mike Alexander)

Attachment: yelp.tgz added

Upgraded yelp port

Changed 17 years ago by mtalexander (Mike Alexander)

Attachment: libxml2.patch added

Patch to upgrade libxml2 port

Changed 17 years ago by mtalexander (Mike Alexander)

Attachment: libxslt.patch added

Patch to upgrade libxslt port

comment:4 Changed 17 years ago by mtalexander (Mike Alexander)

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.

comment:5 Changed 17 years ago by rhwood@…

Cc: rhwood@… added; mas@… removed
Owner: changed from macports-dev@… to rhwood@…
Status: newassigned

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

comment:6 Changed 17 years ago by rhwood@…

Priority: ExpectedNormal
Version: 1.4.3

firefox-x11 upgrade committed in changeset:28578

comment:7 Changed 17 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

comment:8 Changed 17 years ago by rhwood@…

Resolution: fixed
Status: assignedclosed

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

comment:9 Changed 15 years ago by (none)

Milestone: Port Bugs

Milestone Port Bugs deleted

Note: See TracTickets for help on using tickets.