How to compile it

CMPITG edited this page Aug 14, 2012 · 7 revisions

Razor-qt uses CMake as its build tool. See Dependencies for the complete list of requirements and Razor-cmake-Options for customizing build parameters.

First, you need to get the source code, either tarball or by cloning the git repository see github help.

Now, suppose you have downloaded the razorqt-0.4.1.tar.bz2 tarball, here are roughly what you should do next (character $ below indicates the shell prompt with normal user privilege)

  • Place the tarball at your working directory, e.g. ~/src/razor:

    $ mkdir -p ~/src/razor/
    $ cp /where/you/put/the/downloaded/tarball.tar.gz ~/src/razor/
    
  • Unpack the archive. The new directory would be of something like razorqt-0.4.1:

    $ cd ~/src/razor/
    $ tar xf razorqt-0.4.1.tar.gz
    
  • Make a new directory to perform an out-of-source build (recommended way to build software with CMake):

    $ mkdir build
    

    The directory structure is now like the following:

    $ ls
    build  razorqt-0.4.1
    
  • Go to the build directory and run cmake:

    $ cd build
    $ cmake -DCMAKE_INSTALL_PREFIX=../release ../razorqt-0.4.1
    

    Which means: configure the build to be installed in ~/src/razor/release as the root directory instead of the default /usr/local/.

  • There are more useful variables to customize. E.g. -DCMAKE_BUILD_TYPE=debug compiles razor with debugging symbols... Please see CMake documentation for more details. There are also some Razor related Razor-cmake-Options as well.

  • If the configuration phase runs successfully, run make and make install as usual. However, for better management with package manager, checkinstall is preferred over the traditional make install. Anyway, suit yourself.

    $ make
    $ sudo checkinstall # or su -c checkinstall
    $ # Install the created package if neccessary with dkpg -i in Debian-based system or rpm -Uvh in Fedora/RHEL-based systems, ...
    
  • After the build process, one way to use Razor-qt is to make use of .xinitrc as following

    $ echo 'exec razor-session -w openbox' > .xinitrc_razor  # Using openbox as its window manager, you can choose another one as well.
    
  • Now, you could run the new Razor-qt session with the following command, the :1 is used to create a new display so it will not mess up with your current GUI session:

    $ sudo xinit ~/.xinitrc_razor -- :1
    $ # Or su -c 'xinit ~/.xinitrc_razor -- :1' in some other distro