Kuroo - an emerge gui - INSTALLATION

Instructions for stable releases

Kuroo is an application for gentoo's portage and as such resides inside the main portage tree.

All you have to do is open a console as root and enter the following command:
```
emerge kuroo -av
```
Of course it is possible to install kuroo from within kuroo itself in case you are already using it :-)
In case kuroo is still marked as "testing" you have to first unmask it in /etc/portage/package.keywords:
```
echo "app-portage/kuroo" >> /etc/portage/package.keywords
```

Beta releases and release candidates outside the main portage tree

Here is how you install a kuroo version that is not in the portage tree. In the instructions below we use 0.81.0_beta1 as an example. If you want to install any other version, just change every occurance of "0.81.0_beta1" below to your choice. Browse the kuroo ebuilds to find out which versions are currently available.

Download the ebuild of your choice. Beta and release candidates are meant for testing. Feel free to try them and report back if you find any bugs.

Edit your make.conf for local packages

echo PORTDIR_OVERLAY="/usr/local/portage/index.html" >> /etc/make.conf

Unmask kuroo

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

Add local repository for kuroo ebuild and paste the ebuild there

mkdir /usr/local/portage 
mkdir /usr/local/portage/app-portage 
mkdir /usr/local/portage/app-portage/kuroo 
cp kuroo-0.81.0_beta1.ebuild /usr/local/portage/app-portage/kuroo

Download the package, check for integrity and emerge kuroo

cd /usr/local/portage/app-portage/kuroo 
ebuild kuroo-0.81.0_beta1.ebuild digest
emerge kuroo -av

When the compilation has finished, start Kuroo from KDE's start menu: You'll find it in the System category.

Instructions for SVN ebuild

Following are the installation steps to check out Kuroo from the subversion repository. Keep in mind that the resulting installation is only a snapshot of work in progress and subject to fluctual changes. This also means that the application may crash or otherwise not work as expected. If you feel uncomfortable with this, please consider using the latest stable version above.

Edit /etc/make.conf to make sure the portdir overlay is set correctly. The example below uses /usr/local/portage.
Find more information about how to use the overlay at the Gentoo Wiki
```
PORTDIR_OVERLAY=/usr/local/portage
```
Download kuroo-svn-0.81.ebuild (Right-click and save as...).

Place it in your overlay, like e.g.

/usr/local/portage/app-portage/kuroo-svn/kuroo-svn-0.81.ebuild

Run

ebuild /usr/local/portage/app-portage/kuroo-svn/kuroo-svn-0.81.ebuild digest

Unmask Kuroo-svn in /etc/portage/package.keywords:

echo "app-portage/kuroo-svn" >> /etc/portage/package.keywords

Set the "debug" use flag to enable debug output

echo "app-portage/kuroo-svn debug" >> /etc/portage/package.use

Refresh Installed view in kuroo and
```
emerge app-portage/kuroo-svn
```