Difference between revisions of "Gentoo"

From GnuCash
Jump to: navigation, search
(Major revision for the ebuild changes in the last couple of months.)
Line 1: Line 1:
== Gnucash SVN installation on Gentoo ==
+
= Options =
  
This is written for people who do not know Gentoo's mechanism for installing unofficial ebuilds; if you know about PORTDIR_OVERLAY things, you will also know which steps to skip.  (On the other hand you can make this steps twice, it doesn't matter. ;-))
+
There are 4 options for running gnucash on Gentoo:
  
Note that this installation will '''destroy any gnucash-1.8.x''' versions, because of overwriting some files, especially the gnucash binary in /usr/bin/gnucash. It is suggested to deinstall gnucash-1.8.x first.
+
* 1.8.x : official portage stable ebuild
 +
* 1.9.x : non-portage, overlay-able, slotted ebuild of the development releases.  See [http://bugs.gentoo.org/show_bug.cgi?id=122337 Bug#122337].
 +
* svn-ebuild : non-portage, overlay-able, slotted ebuild which pulls from SVN.  See [http://bugs.gentoo.org/show_bug.cgi?id=118863 Bug#118862].
 +
* svn, direct : just build and install yourself, independent of portage
  
If you need support for installing both, please tell me, I can figure out what to do to have them both.
+
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.
  
'''Note:'''
+
= Notes =
If you have any errors during configure or build, and it doesn't come to an end, please send me the last important lines to my email below.  I will then update the ebuild until it works.
 
  
==Installation instructions==
+
If you're unfamiliar with how to setup an portage overlay, see the Gentoo
 +
Handbook's section on [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=3&chap=5#doc_chap2 adding unoffical ebuilds].
  
Do the following as ''root'':
+
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").  Both are
 +
SLOTted so they will install along-side your existing stable 1.8.x version;
 +
this will probably change for the 2.0 release, though.
  
1. Create the directory for gnucash-svn ebuild and change into it.
+
The 1.9.x ebuild DEPENDs on the currently (2006-03-06) keyworded
  mkdir -p /usr/local/portage/app-office/gnucash-svn
+
x11-libs/goffice ebuild, which itself depends on a masked gnome-extra/libgsf
  cd /usr/local/portage/app-office/gnucash-svn
+
ebuild. As the gnucash ebuild it itself keyworded ~x86 (and ~amd64), you'll
2. Download the ebuild from the gentoo bugs.
+
need to add all 3 to your <tt>/etc/portage/package.keywords</tt> file:
  wget <nowiki>http://bugs.gentoo.org/attachment.cgi?id=76978</nowiki> -O gnucash-svn-20060112.ebuild
 
The version number for now does not say which version of svn you install, you install always the current version available via svn.  Double-check [[http://bugs.gentoo.org/show_bug.cgi?id=118862 Gentoo Bug#118862]] to ensure you're getting the latest attached version of the ebuild.
 
  
3. Create digest
+
    =app-office/gnucash-1.9.2 ~x86
  ebuild gnucash-svn-20060112.ebuild digest
+
    =x11-libs/goffice-0.1.0 ~x86
 
+
    =gnome-extra/libgsf-1.13.3 ~x86
4. Now you have the ebuild, so you need to make portage to use it, if you havent done before:
 
  echo "PORTDIR_OVERLAY=\"/usr/local/portage\"" >> /etc/make.conf
 
or you can edit the file with any editor to set this variable.
 
 
 
5. gnucash-svn is marked as unstable ~x86.  If you have x86 (stable) in your /etc/make.conf, so enable ~x86 for gnucash-svn
 
  mkdir -p /etc/portage/
 
  echo "app-office/gnucash-svn ~x86" >> /etc/portage/package.keywords
 
 
 
Thats all.
 
 
 
Oh, wait a moment.  You have now the ebuild for gnucash-svn.  Any install and update will be done with
 
  emerge gnucash-svn
 
 
 
At the first usage it will install gnucash currently svn version.  There are updates nearly every day, so if you need the last you simply rerun
 
  emerge gnucash-svn
 
 
 
This keeps you up to date.
 
 
 
enjoy! ;-)
 
 
 
==Gnucash-1.9.0==
 
If you just want gnucash for gnome2, you can use the developers 1.9.0 version.  This is available at [[http://bugs.gentoo.org/show_bug.cgi?id=122337 Gentoo Bug#122337]].  The steps to use the ebuild are the same, as for gnucash-svn.  (Use /usr/local/portage/app-office/gnucash/gnucash-1.9.0.ebuild as target location for your file.)  Going this way will automaticaly remove your 1.8.x installation - only if you are using unstable (~x86).
 
 
 
==Speeding up==
 
 
 
Gnucash takes a long time to build.  You can speed it up if you use the [http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=3#doc_chap3 ccache] feature, where allready built things will be stored in a cache and we will only rebuild new things or things where the configuration has changed.
 
 
 
==Troubles with goffice?==
 
 
 
Today I noticed that the last update makes troubles building goffice related things.  This depends on gnucash, which finds goffice from a previous gnucash-svn installation and things there is a native goffice installed.
 
 
 
If you have the same problem simple deinstall gnucash-svn and reinstall it, but make a package before, in case your update build fails:
 
  quickpkg gnucash-svn
 
  emerge -C gnucash-svn && emerge gnucash-svn
 
In case building fails, you can restore the old version of gnucash-svn with
 
  emerge -k gnucash-svn
 
 
 
 
 
If that doesn't help you, please tell me.
 
 
 
 
 
- Martin <martin.klaffenboeck@gmx.at>
 

Revision as of 15:23, 7 March 2006

Options

There are 4 options for running gnucash on Gentoo:

  • 1.8.x : official portage stable ebuild
  • 1.9.x : non-portage, overlay-able, slotted ebuild of the development releases. See Bug#122337.
  • svn-ebuild : non-portage, overlay-able, slotted 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.

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"). Both are SLOTted so they will install along-side your existing stable 1.8.x version; this will probably change for the 2.0 release, though.

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