Revision as of 02:32, 10 September 2006

Options

There are 5 options for running gnucash on Gentoo:

• 2.0.1 : official portage unstable ebuild with direct connect
• 1.8.x : official portage stable ebuild
• 1.9.x : non-portage, overlay-able, ebuild of the development releases. See Bug#122337.
• svn-ebuild : non-portage, overlay-able, ebuild which pulls from SVN. See Bug#118862.
• svn, direct : just build and install yourself, independent of portage

If you're unsure which you want, then you want either the 1.8.x stable version or the 1.9.x development/unstable version, and you probably want the latter.

Quickstart

 $ cd «your portage overlay dir»
 $ mkdir -p app-office/gnucash
 $ cd app-office/gnucash
 $ wget http://svn.gnucash.org/repo/gnucash/trunk/packaging/gnucash-1.9.x.ebuild -O gnucash-1.9.2.ebuild
 $ ebuild gnucash-1.9.2.ebuild digest
 $ emerge =gnucash-1.9.2

Notes

If you're unfamiliar with how to setup an portage overlay, see the Gentoo Handbook's section on adding unoffical ebuilds.

The 1.9.x and svn ebuilds use the same ebuild script, which changes its behavior based on the package name ("gnucash" or "gnucash-svn").

The 1.9.x ebuild DEPENDs on the currently (2006-03-06) keyworded x11-libs/goffice ebuild, which itself depends on a masked gnome-extra/libgsf ebuild. As the gnucash ebuild it itself keyworded ~x86 (and ~amd64), you'll need to add all 3 to your /etc/portage/package.keywords file:

   =app-office/gnucash-1.9.2 ~x86
   =x11-libs/goffice-0.1.0 ~x86
   =gnome-extra/libgsf-1.13.3 ~x86

For GnuCash 2.0.x with direct connect

Here is what you need:

  1]. Make sure you libofx-0.8.2 or greater installed
  2]. Make sure you have aqbanking-2.2.1 or better with "USE=hbci" installed
  3]. Finally emerge gnucash-2.0.1 or better with "USE= ofx hbci"

The following are some problems you (i did as of Sept. 9 2006) might run into:

• Emerging libofx-0.8.2

This version or better of the package is necessary for direct connect support. As of current speaking (see above) this package is not availabe in gentoo portage. So you will have to use an custom overlay e-build. Do i hear some bitch and moan? Don't worry this is real easy. Here is what you got to do:

  1].  Emerge the current available version of libofx, which currently is libofx-0.8.1-r1
  2].  Create the following directory
       a). $ mkdir -p /usr/local/portage/dev-libs/libofx
  3].  Make portage aware of your overlay directory
       a). $ echo 'PORTDIR_OVERLAY=/usr/local/portage' >> /etc/make.conf
  4].  Copy libofx-0.8.1-r1 e-build and patches to new overlay directory
       a). $ cp -R /usr/portage/dev-libs/libofx/libofx-0.8.1-r1.ebuild /usr/local/portage/dev-libs/libofx/libofx-2.0.1.ebuild
  5].  Finally copy any patches (you proboably will not need these but just in case)
       a). $ cp -R /usr/portage/dev-libs/libofx/files/* /usr/local/portage/dev-libs/libofx/files/
  6].  Make a digest
       a). $ ebuild /usr/local/portage/dev-libs/libofx/libofx-2.0.1.ebuild digest

Now edit the ebuild file by running

  1].  $ nano /usr/local/portage/dev-libs/libofx/libofx-2.0.1.ebuild