-all: hacking-howto.html debugging.html userguide.html ipc.html multi-monitor.html wsbar.html tree-migrating.html i3status.html i3.html
+all: hacking-howto.html debugging.html repositories.html userguide.html ipc.html multi-monitor.html wsbar.html tree-migrating.html i3status.html i3.html
hacking-howto.html: hacking-howto
asciidoc -a linkcss -a stylesdir=/css -a scriptsdir=/js --backend=xhtml11 -f conf/i3html.conf -a toc -n $<
debugging.html: debugging
asciidoc -a linkcss -a stylesdir=/css -a scriptsdir=/js --backend=xhtml11 -f conf/i3html.conf -n $<
+repositories.html: repositories
+ asciidoc -a linkcss -a stylesdir=/css -a scriptsdir=/js --backend=xhtml11 -f conf/i3html.conf -n $<
+
userguide.html: userguide
asciidoc -a linkcss -a stylesdir=/css -a scriptsdir=/js --backend=xhtml11 -f conf/i3html.conf -a toc -n $<
--- /dev/null
+Debian and Ubuntu repositories
+==============================
+Michael Stapelberg <michael+i3@stapelberg.de>
+July 2011
+
+== When should you use our repositories?
+
+In general, you should use the repositories of your distribution. Adding
+third-party repositories to your +/etc/sources.list+ has security implications
+and makes your +apt-get update+ take longer. However, in some cases, using our
+repositories makes sense:
+
+You are using Debian stable::
+ The latest version of i3 will be in Debian testing quite soon. The version
+ in Debian stable can be old, however (we cannot update it after stable has
+ been released). The best way is to add Debian testing and tell +apt+ to
+ prefer Debian stable. You should *not* use our repository.
+You are using Ubuntu::
+ Only a handful of packages are maintained by Ubuntu developers. The rest is
+ synchronized periodically from Debian, every 6 months. Therefore, Ubuntu
+ often includes old versions of i3. You should use our Ubuntu repository.
+You want the latest i3 development version::
+ If you are using Debian (Debian-derived systems might work, too) and want
+ the latest development version of i3, you should use our Debian repository.
+
+== Ubuntu repository
+
+The Ubuntu repository is provided by sur5r and contains the latest stable release
+of i3. To use it, run the following commands:
+
+---------------------------------------------------------------------------------
+# echo 'deb http://debian.sur5r.net/i3/ karmic universe' >> /etc/apt/sources.list
+# apt-get update
+# apt-get install i3
+---------------------------------------------------------------------------------
+
+== Debian repository
+
+Our Debian repository contains packages which are automatically built a few
+minutes after every commit. To use it, run the following commands:
+
+---------------------------------------------------------------------------------
+# echo 'deb http://build.i3wm.org/debian/i3-wm sid main' >> /etc/apt/sources.list
+# apt-get update
+# apt-get install i3-wm
+---------------------------------------------------------------------------------
+
+To ensure that the autobuilt i3 packages will be preferred to the packages of
+your distribution, put the following entry *at the beginning* of your
++/etc/apt/preferences+:
+
+----------------------------
+Package: *
+Pin: origin "build.i3wm.org"
+Pin-Priority: 1001
+----------------------------
+
+Then, install +i3-wm+.
--- /dev/null
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"\r
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">\r
+<head>\r
+<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />\r
+<meta name="generator" content="AsciiDoc 8.6.4" />\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
+/*]]>*/\r
+</script>\r
+<script type="text/javascript" src="/js/asciidoc-xhtml11.js"></script>\r
+</head>\r
+<body class="article">\r
+\r
+ <div id="main">\r
+ <a href="/"><h1 id="title">i3 - improved tiling WM</h1></a>\r
+ <ul id="nav">\r
+ <li><a style="border-bottom: 2px solid #fff" href="/docs">Docs</a></li>\r
+ <li><a href="/screenshots">Screens</a></li>\r
+ <li><a href="/contact">Contact</a></li>\r
+ <li><a href="http://bugs.i3wm.org/">Bugs</a></li>\r
+ </ul>\r
+ <br style="clear: both">\r
+<div id="content">\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">July 2011</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
+<div class="sectionbody">\r
+<div class="paragraph"><p>In general, you should use the repositories of your distribution. Adding\r
+third-party repositories to your <tt>/etc/sources.list</tt> has security implications\r
+and makes your <tt>apt-get update</tt> take longer. However, in some cases, using our\r
+repositories makes sense:</p></div>\r
+<div class="dlist"><dl>\r
+<dt class="hdlist1">\r
+You are using Debian stable\r
+</dt>\r
+<dd>\r
+<p>\r
+ The latest version of i3 will be in Debian testing quite soon. The version\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
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+You are using Ubuntu\r
+</dt>\r
+<dd>\r
+<p>\r
+ Only a handful of packages are maintained by Ubuntu developers. The rest is\r
+ synchronized periodically from Debian, every 6 months. Therefore, Ubuntu\r
+ often includes old versions of i3. You should use our Ubuntu repository.\r
+</p>\r
+</dd>\r
+<dt class="hdlist1">\r
+You want the latest i3 development version\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
+</p>\r
+</dd>\r
+</dl></div>\r
+</div>\r
+</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="listingblock">\r
+<div class="content">\r
+<pre><tt># echo 'deb http://debian.sur5r.net/i3/ karmic universe' >> /etc/apt/sources.list\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="_debian_repository">3. Debian repository</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph"><p>Our Debian 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/debian/i3-wm sid main' >> /etc/apt/sources.list\r
+# apt-get update\r
+# apt-get install i3-wm</tt></pre>\r
+</div></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
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>Package: *\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>\r
+</div>\r
+</div>\r
+<div id="footnotes"><hr /></div>\r
+<div id="footer" lang="de">\r
+© 2009-2011 Michael Stapelberg, <a href="/impress.html">Impressum</a>\r
+</div>\r
+</body>\r
+</html>\r
% endfor
</div>
-<!--
<p>
- Because Ubuntu packages are always outdated, you can also install
- up-to-date third-party i3 packages for Ubuntu by adding the following line
- to your <code>/etc/apt/sources.list</code> and using <code>apt-get install
- i3</code> afterwards:<br>
- <pre>
- deb http://debian.sur5r.net/i3/ karmic universe
- </pre>
- Or, if you are running lucid:
- <pre>
- deb http://debian.sur5r.net/i3/ lucid universe
- </pre>
-</p>
--->
-<p>
-Because Ubuntu syncs its packages only every 6 months with Debian, we provide a more recent repository.
+We also provide <a href="/docs/repositories.html">Debian and Ubuntu repositories</a> with up-to-date packages.
</p>
<h2>Downloads</h2>
<h2>Development version</h2>
<p>
- Use <a href="http://git-scm.com/">git</a> to follow the latest changes:
+ Use <a href="http://git-scm.com/">git</a> to follow the latest changes. This command checks out the 'master' branch:
</p>
<pre>
- $ git clone git://code.stapelberg.de/i3
+ $ git clone git://code.i3wm.org/i3
</pre>
+<p>
+ The 'master' branch is the current stable version plus bugfixes.<br>
+ The 'next' branch is the next version, yet to be released. Use <tt>git
+ checkout next</tt> to switch to the 'next' branch.
+</p>
+
<p>
If you prefer to download a tarball, or if you cannot use git for whatever reason,
you may download the current master branch from
- <a href="http://code.stapelberg.de/git/i3/snapshot/i3-master.tar.bz2">
- http://code.stapelberg.de/git/i3/snapshot/i3-master.tar.bz2
+ <a href="http://code.i3wm.org/i3/snapshot/i3-master.tar.bz2">
+ http://code.i3wm.org/i3/snapshot/i3-master.tar.bz2
</a>
</p>
projects / i3 / i3.github.io / commitdiff