Help/documentation installation on Mac

[John Ralls]

On Jan 11, 2010, at 3:33 AM, James Wilde wrote:

> I'm using GC on a Mac running Snow Leopard (10.6.2).  I'm new to the Mac, and am having some problems installing the help and documentation.  To do this I have to install a program called scrollkeeper, which in its turn requires a number of prerequisite programs, such as libxml2 and a bunch of other stuff.  Now it looks like I need some kind of equivalent to apt-get in the Ubuntu linux world.
> 
> I appreciate that this message might more appropriately belong on an Apple forum, but I'll post it here anyway.  Perhaps people who may be able to help can do it off-line so as not to overload the GC list.
> 
> If there is a Mac user who has successfully installed the documentation on a recent version of Mac OSX I'd very much appreciate a simple guideline to take me through the process.  On the Mac I'm hoping not to have to get quite so involved in nuts and bolts as I did when I was working in a big company IT department and maintaining Solaris and various linux distros, but if I have to, I can.
> 

The documentation is provided in HTML format in the app bundle, as noted in the Readme file. 

Being able to use the help menu as Gnucash is written requires Yelp (Gnome's help reader), Scrollkeeper, and perhaps other infrastructure. Providing all of that would require using an installer instead of drag-and-drop, and would anyway duplicate functionality already provided by OSX. A more profitable approach would be to write a Docbook->Apple Help XSLT stylesheet; then the menus could be changed to just launch Apple help.

If you want to learn more about building Gtk+ applications on OSX, visit http://gtk-osx.sourceforge.net. Note that it's not a user-friendly undertaking. Substantial programming experience is required to be assured of success.

Regards,
John Ralls