unexist.dev

h1. Install\015\012\015\012{{>toc}}\015\012\015\012h2. Dependencies\015\012\015\012[[subtle]] has the following dependencies:\015\012\015\012# "Ruby":http://www.ruby-lang.org (>=1.9)\015\012# "Rake":http://rake.rubyforge.org (>=0.8)\015\012# "X11":http://xorg.freedesktop.org (>=6.8.2)\015\012\015\012And the following optional "gem":http://rubygems.org dependencies for [[sur]]:\015\012\015\012# "archive-tar-minitar":http://rubyforge.org/projects/ruwiki (>=0.5.2)\015\012# "datamapper":http://datamapper.org (>=0.9.11) ([[surserver]] only)\015\012# "sinatra":http://www.sinatrarb.com (>=0.9.4) ([[surserver]] only)\015\012\015\012\015\012h2. Versions\015\012\015\012If you are using one of the [[install#distributions|supported distributions]], you can follow the appropriate installation instructions below to install the stable version of [[subtle]] _or_ you can choose to follow the directions at the end of the page to [[Install#Installing-development-version|install the latest _development_ version]].\015\012\015\012* *Stable releases* are available on this site's "file download page":http://subforge.org/projects/subtle/files\015\012* *Development versions* can be found in [[subtle]]'s "Mercurial":http://www.selenic.com/mercurial respository. This repo is available for read-only hg access at http://hg.subforge.org/subtle and is browseable on the web "here":http://subforge.org/projects/subtle/repository.\015\012\015\012\015\012h2. Distributions\015\012\015\012h3. Archlinux\015\012\015\012Currently there are two different packages available:\015\012\015\012* "subtle":http://www.archlinux.org/packages/community/i686/subtle/ (current stable)\015\012* "subtle-hg":http://aur.archlinux.org/packages.php?ID=13139 (developer snapshot)\015\012\015\012The stable version is in community and can be installed with "pacman":https://wiki.archlinux.org/index.php/Pacman, the developer snapshot is in "AUR":http://aur.archlinux.org and needs either a special tool like "yaourt":http://aur.archlinux.org/packages.php?ID=5863, "clyde":http://aur.archlinux.org/packages.php?ID=34686 or "packer":http://aur.archlinux.org/packages.php?ID=33378 or can be installed manually.\015\012\015\012h3. Debian\015\012\015\012Since a pre-compiled package for [[Install#Debian|Debian]] does not yet exist, you need to compile [[subtle]] to get it up and running.\015\012\015\012# Install the dependencies with *apt-get*: libx11-dev, rake1.9.1, ruby1.9.1, ruby1.9.1-dev, pkg-config\015\012\015\012 <pre><code>sudo apt-get install libx11-dev rake1.9.1 ruby1.9.1 ruby1.9.1-dev pkg-config</code></pre>\015\012# (Optional) Install optional dependencies for RandR, Xft, Xinerama, and Xpm with *apt-get*: libxrandr-dev, libxft-dev, libxinerama-dev, libxpm-dev\015\012 <pre><code>sudo apt-get install libxrandr-dev libxft-dev libxinerama-dev libxpm-dev</code></pre>\015\012# Download either the latest stable package or clone the "Mercurial":http://www.selenic.com/mercurial repository\015\012# Change dir into the [[subtle]] folder (stable or latest) and issue rake: (rake1.9.1 for the latest version):\015\012yet\015\012 <pre><code>rake1.9</code></pre>\015\012\015\012 This should configure and get you ready for install\015\012# Issue the following command to install it:\015\012\015\012 <pre><code>sudo rake1.9.1 install</code></pre>\015\012\015\012h3. Exherbo\015\012\015\012Make sure to update "jedahan's repository":http://github.com/jedahan/jedahan-exheres\015\012\015\012 cave resolve -x jedahan\015\012\015\012Then install subtle like so\015\012\015\012 cave resolve -x subtle\015\012\015\012h3. Gentoo\015\012\015\012Currently there are two different overlays:\015\012\015\012Both are available via "github":https://github.com:\015\012\015\012# https://github.com/damex/subtle-overlay (This one is also available via "layman":http://layman.sourceforge.net, "layman userguide":http://www.gentoo.org/proj/en/overlays/userguide.xml)\015\012# https://github.com/shurizzle/shura-overlay/tree/subtle\015\012\015\012h3. Ubuntu\015\012\015\012_Tested on Ubuntu Maverick (10.10) and Natty (11.04)_\015\012\015\012Since a pre-compiled package for [[Install#Ubuntu|Ubuntu]] doesn't exist yet, you will need to compile [[subtle]] to get it up and running.\015\012\015\012# Install [[subtle]]'s dependencies (libx11-dev, ruby1.9.1, ruby1.9.1-dev, libruby1.9.1 and rake) using *apt-get*: \015\012\015\012 <pre><code>sudo apt-get install libx11-dev rake ruby1.9.1 ruby1.9.1-dev libruby1.9.1</code></pre>\015\012# Download the latest archive from the "files page":http://subforge.org/projects/subtle/files, and extract its contents:\015\012\015\012 <pre><code>\015\012 curl -O http://subforge.org/attachments/download/50/subtle-0.9.2773-mu.tbz2\015\012 tar xvf subtle-0.9.2773-mu.tbz2\015\012 </code></pre>\015\012 _Note that the current version number may differ from that shown in these example commands, so make sure you visit the "files section":http://subforge.org/projects/subtle/files to get the latest and greatest version/filename._\015\012# Now go in the newly created folder and run rake (rake1.9.1 to use the latest version), which will configure and prepare [[subtle]] for installation:\015\012\015\012 <pre><code>\015\012 cd subtle-0.9.2773-mu/\015\012 rake1.9\015\012 </code></pre>\015\012# Issue the following command to install subtle:\015\012\015\012 <pre><code>sudo rake1.9.1 install</code></pre>\015\012# Add a [[subtle]] session to your xsessions:\015\012\015\012 <pre><code>sudo nano /usr/share/xsessions/subtle.desktop</code></pre>\015\012\015\012 And add this:\015\012\015\012 <pre><code>\015\012 [Desktop Entry]\015\012 Encoding=UTF-8\015\012 Name=subtle\015\012 Comment=subtle tiling window manager\015\012 Exec=subtle\015\012 Type=XSession\015\012 </code></pre>\015\012# Finally, reboot and enjoy [[subtle]]!\015\012\015\012h5. Note for PulseAudio users\015\012\015\012If you are using "PulseAudio":http://www.pulseaudio.org/ and want to start [[subtle]] using just your *xinitrc*, you can get working audio by adding the following line to your .xinitrc file:\015\012\015\012<pre><code>exec ck-launch-session subtle</code></pre>\015\012\015\012h2. Install Development Version\015\012\015\012You can install the current development version of [[subtle]] by cloning and installing from the "Mercurial":http://www.selenic.com/mercurial/ "subtle repository":http://hg.subforge.org/subtle:\015\012\015\012# <code>hg clone http://hg.subforge.org/subtle</code>\015\012# cd subtle\015\012# rake [options]\015\012# sudo rake install\015\012\015\012The installer will copy the files to following "XDG":http://standards.freedesktop.org/basedir-spec/latest/ default path: (see: rake help)\015\012\015\012| *Binaries* | _/usr/bin_ |\015\012| *Config* | _/etc/xdg/subtle_ |\015\012| *Extension* | _&#40;Ruby Dir&#41;/subtle_ |\015\012\015\012The paths can be easily changed (see: "rake":http://rake.rubyforge.org help) and are printed after configuring is done. \015\012\015\012{{warn(The buildsystem creates [[subtle]] will create cache files to keep track of the settings and to speed up further builds. When settings, so whenever you want need to change compile options and/or the "Ruby":http://ruby-lang.org version, a path later you must *must* will need to delete the cache files before or otherwise the build may fail. This can be done with old caches by running @rake clobber@.)}}\015\012\015\012h3. clobber@.\015\012\015\012h3. Debugging\015\012\015\012To enable debugging messages and levels, [[subtle]] must be compiled with debugging support. Since there is usually no debugging package available, it needs to be compiled manually:\015\012\015\012# hg clone http://hg.subforge.org/subtle\015\012# cd subtle\015\012# rake debug=yes\015\012# rake install\015\012\015\012[[subtle]] can be run directly from the source directory with no need to install it system-wide, just add it to e.g. your @~/.xinitrc@.\015\012