<head>\r
<link rel="icon" type="image/png" href="/favicon.png">\r
<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
-<meta name="generator" content="AsciiDoc 8.6.4" />\r
+<meta name="generator" content="AsciiDoc 8.6.9" />\r
<title>i3: Debian and Ubuntu repositories</title>\r
<link rel="stylesheet" href="/css/style.css" type="text/css" />\r
<link rel="stylesheet" href="/css/xhtml11.css" type="text/css" />\r
<script type="text/javascript">\r
/*<![CDATA[*/\r
-window.onload = function(){asciidoc.footnotes();}\r
+document.addEventListener("DOMContentLoaded", function(){asciidoc.footnotes();}, false);\r
/*]]>*/\r
</script>\r
<script type="text/javascript" src="/js/asciidoc-xhtml11.js"></script>\r
<div id="header">\r
<h1>Debian and Ubuntu repositories</h1>\r
<span id="author">Michael Stapelberg</span><br />\r
-<span id="email"><tt><<a href="mailto:michael+i3@stapelberg.de">michael+i3@stapelberg.de</a>></tt></span><br />\r
-<span id="revdate">October 2011</span>\r
+<span id="email"><tt><<a href="mailto:michael@i3wm.org">michael@i3wm.org</a>></tt></span><br />\r
+<span id="revdate">July 2013</span>\r
</div>\r
<div class="sect1">\r
<h2 id="_when_should_you_use_our_repositories">1. When should you use our repositories?</h2>\r
in Debian stable can be old, however (we cannot update it after stable has\r
been released). The best way is to add Debian testing and tell <tt>apt</tt> to\r
prefer Debian stable. You should <strong>not</strong> use our repository.\r
+ Alternatively, you can also use\r
+ <a href="http://backports.debian.org/">stable-backports (e.g. wheezy-backports for\r
+ Debian wheezy)</a>.\r
</p>\r
</dd>\r
<dt class="hdlist1">\r
</dt>\r
<dd>\r
<p>\r
- If you are using Debian (Debian-derived systems might work, too) and want\r
- the latest development version of i3, you should use our Debian repository.\r
+ If you are using Debian (Debian-derived systems might work, too) or Ubuntu\r
+ and want the latest development version of i3, you should use our Debian\r
+ repository.\r
</p>\r
</dd>\r
</dl></div>\r
<div class="sect1">\r
<h2 id="_ubuntu_repository">2. Ubuntu repository</h2>\r
<div class="sectionbody">\r
-<div class="paragraph"><p>The Ubuntu repository is provided by sur5r and contains the latest stable release\r
-of i3. To use it, run the following commands:</p></div>\r
+<div class="sect2">\r
+<h3 id="_stable_releases">2.1. Stable releases</h3>\r
+<div class="paragraph"><p>This Ubuntu repository is provided by sur5r and contains the latest stable\r
+release of i3. To use it, run the following commands:</p></div>\r
<div class="listingblock">\r
<div class="content">\r
-<pre><tt># echo 'deb http://debian.sur5r.net/i3/ natty universe' >> /etc/apt/sources.list\r
+<pre><tt># echo "deb http://debian.sur5r.net/i3/ $(lsb_release -c -s) universe" >> /etc/apt/sources.list\r
# apt-get update\r
# apt-get --allow-unauthenticated install sur5r-keyring\r
# apt-get update\r
# apt-get install i3</tt></pre>\r
</div></div>\r
-<div class="paragraph"><p>The following Ubuntu versions are currently available: maverick, natty, oneiric.</p></div>\r
+<div class="paragraph"><p>The following Ubuntu versions are currently available: oneiric, precise, quantal,\r
+raring, saucy, trusty.</p></div>\r
+</div>\r
+<div class="sect2">\r
+<h3 id="_development_releases">2.2. Development releases</h3>\r
+<div class="paragraph"><p>This Ubuntu repository contains packages which are automatically built a few\r
+minutes after every commit. To use it, run the following commands:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt># echo 'deb http://build.i3wm.org/ubuntu/raring raring main' >> /etc/apt/sources.list\r
+# apt-get update\r
+# apt-get --allow-unauthenticated install i3-autobuild-keyring\r
+# apt-get update\r
+# apt-get install i3</tt></pre>\r
+</div></div>\r
+<div class="paragraph"><p>Development versions are only available for the latest version of Ubuntu, which\r
+is raring at the moment.</p></div>\r
+</div>\r
</div>\r
</div>\r
<div class="sect1">\r
minutes after every commit. To use it, run the following commands:</p></div>\r
<div class="listingblock">\r
<div class="content">\r
-<pre><tt># echo 'deb http://build.i3wm.org/debian/i3-wm sid main' >> /etc/apt/sources.list\r
+<pre><tt># echo 'deb http://build.i3wm.org/debian/sid sid main' > /etc/apt/sources.list.d/i3-autobuild.list\r
+# apt-get update\r
+# apt-get --allow-unauthenticated install i3-autobuild-keyring\r
# apt-get update\r
-# apt-get install i3-wm</tt></pre>\r
+# apt-get install i3</tt></pre>\r
</div></div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_preferring_the_autobuilder_version_of_i3">4. Preferring the autobuilder version of i3</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph"><p>On installations where you have multiple sources (stable and testing, or\r
+testing and unstable for example), <tt>apt-get install i3</tt> might not get you the\r
+autobuilder version.</p></div>\r
<div class="paragraph"><p>To ensure that the autobuilt i3 packages will be preferred to the packages of\r
-your distribution, put the following entry <strong>at the beginning</strong> of your\r
-<tt>/etc/apt/preferences</tt>:</p></div>\r
+your distribution, create the file\r
+<tt>/etc/apt/preferences.d/00-i3-autobuild.pref</tt> with the following contents:</p></div>\r
<div class="listingblock">\r
<div class="content">\r
-<pre><tt>Package: *\r
+<pre><tt>Package: i3*\r
Pin: origin "build.i3wm.org"\r
Pin-Priority: 1001</tt></pre>\r
</div></div>\r
-<div class="paragraph"><p>Then, install <tt>i3-wm</tt>.</p></div>\r
+<div class="paragraph"><p>Then, run <tt>apt-get update</tt> and install <tt>i3</tt>.</p></div>\r
</div>\r
</div>\r
</div>\r