Installation

Quick Guide (for the impatient geek)

1. Put the ebuild in app-portage/glcu in your portage-overlay
2. digest the ebuild: ebuild glcu-0.9.7.2.ebuild digest
3. put glcu in /etc/portage/package.keywords: echo "app-portage/glcu ~x86" >> /etc/portage/package.keywords
4. emerge glcu: emerge --ask --verbose glcu
5. edit the glcu config file /etc/glcu.conf
   (This was /etc/conf.d/glcu before version 0.9.7.2)

Complete Guide (with lots of explanations)

If you've used the bash version of glcu in /etc/cron.daily or /etc/cron.weekly you should delete it first:

rm /etc/cron.daily/glcu
(or rm /etc/cron.weekly/glcu )

If you haven't updated your system for a long time, I suggest that you update your system once by hand (emerge system/world and glsa-check --fix new) before you use glcu.

To install glcu, just put the ebuild in the app-portage/glcu directory (you have to create this directory if it don't exist) in your portage-overlay (usually /usr/local/portage/app-portage/glcu). If you've never used the portage-overlay before, you need to activate it in your /etc/make.conf (look for PORTDIR_OVERLAY).

Then go into that directory and digest the ebuild:

cd /usr/local/portage/app-portage/glcu
ebuild glcu-0.9.7.2.ebuild digest

Next, put glcu in /etc/portage/package.keywords:

echo "app-portage/glcu ~x86" >> /etc/portage/package.keywords

Then you can emerge glcu:

emerge --ask --verbose glcu

If you want eix or esearch supported, you have to use the USE-flags, e.g.:

USE="eix" emerge --ask --verbose glcu

Or put it in /etc/portage/package.use, which is even better:

echo "app-portage/glcu eix esearch" >> /etc/portage/package.use

Finally you must edit the glcu config file /etc/glcu.conf otherwise glcu won't work.
(The config file was /etc/conf.d/glcu before version 0.9.7.2)

Then, all you have to do is wait for a mail from glcu and follow the instructions in the eMail.

Update to a new version

Version 0.9.7.2 has a new ebuild and the config file moved from /etc/conf.d/glcu to /etc/glcu.conf. Therefore please download the new ebuild, digest it, emerge glcu and then move the config file:

cd /usr/local/portage/app-portage/glcu
wget http://www.panhorst.com/glcu/download/glcu-0.9.7.2.ebuild
ebuild glcu-0.9.7.2.ebuild digest
emerge -av glcu
mv /etc/conf.d/glcu /etc/glcu.conf

Other architectures than x86

I can only test x86 architecture, therefore the ebuild is at the moment only for ~x86. The program should work on other architectures as well. Just add your arch to the ebuild (e.g. KEYWORDS="~x86 ~ppc" and if it worked for you please report back to me - I will update the ebuild.

Thanks to Puca for testing the amd64 platform!
Thanks to coutts99 fort testing the sparc platform!