]> git.sur5r.net Git - i3/i3.github.io/blobdiff - docs/repositories.html
projects / i3 / i3.github.io / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | tree
raw | inline | side by side
repositories: create separate files instead of using /etc/apt/{preferences,sources...
[i3/i3.github.io] / docs / repositories.html
diff --git a/docs/repositories.html b/docs/repositories.html
index f11e5361833f8fa18450b9d783d4e8e981843a04..32131c9a9cae76bedcd0cb2166633da868bcf7a3 100644 (file)
--- a/docs/repositories.html
+++ b/docs/repositories.html
@@ -2,8 +2,9 @@
     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
 <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.6" />\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
@@ -29,8 +30,8 @@ window.onload = function(){asciidoc.footnotes();}
 <div id="header">\r
 <h1>Debian and Ubuntu repositories</h1>\r
 <span id="author">Michael Stapelberg</span><br />\r
-<span id="email"><tt>&lt;<a href="mailto:michael+i3@stapelberg.de">michael+i3@stapelberg.de</a>&gt;</tt></span><br />\r
-<span id="revdate">July 2011</span>\r
+<span id="email"><tt>&lt;<a href="mailto:michael@i3wm.org">michael@i3wm.org</a>&gt;</tt></span><br />\r
+<span id="revdate">June 2012</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
@@ -66,8 +67,9 @@ You want the latest i3 development version
 </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
@@ -76,14 +78,36 @@ You want the latest i3 development version
 <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/ karmic universe' &gt;&gt; /etc/apt/sources.list\r
+<pre><tt># echo "deb http://debian.sur5r.net/i3/ $(lsb_release -c -s) universe" &gt;&gt; /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,\r
+precise.</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/oneiric oneiric main' &gt;&gt; /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 oneiric at the moment.</p></div>\r
+</div>\r
 </div>\r
 </div>\r
 <div class="sect1">\r
@@ -93,20 +117,30 @@ of i3. To use it, run the following commands:</p></div>
 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' &gt;&gt; /etc/apt/sources.list\r
+<pre><tt># echo 'deb http://build.i3wm.org/debian/sid sid main' &gt; /etc/apt/sources.list.d/i3-autobuild.list\r
 # apt-get update\r
-# apt-get install i3-wm</tt></pre>\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>\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
i3wm.org