* First make sure the dependencies are met

  * If you have an older kernel you may additionally need my kmod-roccat package.

    If not done already, download it from
    
    http://sourceforge.net/projects/roccat/
    
    and install it according to the contained instructions

  * You will need some development tools and header packages.
    Please mind that the packages have distribution dependent names. Fedora,
    Ubuntu and openSuse are showcased here:
    
	* Fedora
	
	  $ sudo yum install gcc cmake libcanberra-devel dbus-glib-devel gtk2-devel libgudev1-devel libnotify-devel libusb1-devel libX11-devel
	  
	* Ubuntu
	
	  $ sudo apt-get install gcc cmake libcanberra-dev libdbus-glib-1-dev libgtk2.0-dev libgudev-1.0-dev libnotify-dev libusb-1.0-0-dev libx11-dev
	  
	* openSuse
	
	  $ yast -i gcc cmake libcanberra-devel dbus-1-glib-devel gtk2-devel libgudev-1_0-devel libnotify-devel libusb-1_0-devel libX11-devel

* Compilation and Installation

  In any shell type the following:

  $ tar -xjf roccat-tools-X.X.X.tar.bz2
  $ cd roccat-tools-X.X.X
  $ mkdir build
  $ cd build
  $ cmake -DCMAKE_INSTALL_PREFIX="/usr" ..
  $ make
  $ sudo make install

  * optional cmake entries you can set with -D:

    * LIBDIR    If cmake doesn't find the right install directory for libraries,
      you can set it manually. For 64bit systems that's normally $PREFIX/lib64
      but Ubuntu uses $PREFIX/lib/x86_64-linux-gnu/

    * UDEVDIR   If cmake doesn't find the right install directory for udev rules,
      you can set it manually. Normally it's /lib/udev/rules.d but Fedora 17
      started to merge /lib into /usr/lib completely.

    * UINPUTDIR If cmake doesn't find the right location of the uinput device,
      you can set it manually. Autodetection needs module uinput loaded.
      Normally it's in /dev or /dev/input.
      
    * DEVICES   If omitted, tools for all devices are compiled and installed.
      You can give a semicolon separated list with as many supported devices
      as you want e.g. -DDEVICES="isku;koneplus".

  * It is strongly recommended to install everything in /usr instead of the default
    directory /usr/local.

* Last steps

  * Make the libraries known to the dynamic linker
  
    Just call
    
    $ sudo /sbin/ldconfig
    
    after installation.

  * Refresh the icon cache
  
    Call the command

    $ sudo touch --no-create /usr/share/icons/hicolor

    where /usr has to be substituted with your install prefix.
    This has to be done only for the first time.
    
  * To use the device features as normal user you have to add yourself and all
    other users to a group called roccat.
  
    $ sudo groupadd roccat
    $ sudo usermod -a -G roccat $USER
    
  * Create a folder for systemwide profile storage

    $ sudo mkdir /var/lib/roccat
    $ sudo chown root:roccat /var/lib/roccat
    $ sudo chmod 2770 /var/lib/roccat
     
  * Some devices (Arvo, Kone) need uinput for some features. To use it as normal
    user you can either create an extra group like uinput-users and add yourself
    to this group (as described above) or reuse group roccat.
    Create a file like /etc/udev/rules.d/90-uinput.rules containing the line
    KERNEL=="uinput", GROUP="uinput-users", MODE="0660"
    and replace the group name with your choice.
	
  * To be on the save side you can update the udev rules
  
    $ sudo udevadm control --reload-rules

  * Do a logout/login to apply your new group ownership and replug your device
    and everything should work as expected.

* Using the software under GNOME

  * The GUIs can be found in the menu System/Settings
  
  * The eventhandler is autostarted via a .desktop file in /etc/xdg/autostart
	
* Building an rpm

  The package contains the file roccat-tools.spec that fits at least fedora which
  you can use.
  The easiest way is to write
  
  $ rpmbuild -ta --clean roccat-tools-X.X.X.tar.bz2
  
  which creates all rpms on the fly
