]> git.sur5r.net Git - i3/i3/blobdiff - DEPENDS
Merge pull request #3448 from orestisf1993/sticky
[i3/i3] / DEPENDS
diff --git a/DEPENDS b/DEPENDS
index 0e1de719fe3c116f71af67faf37501c232b9cedd..9a92f99e1193f6912aa33e428b3c3a32ff28c8a7 100644 (file)
--- a/DEPENDS
+++ b/DEPENDS
@@ -1,24 +1,44 @@
-You need the following libraries. The version given is to be understand as the minimum
-version. However, if any of these libraries changes the API, i3 may not compile anymore.
-In that case, please try using the versions mentioned below until a fix is provided.
 
- * xcb-proto-1.3 (2008-12-10)
- * libxcb-1.1.93 (2008-12-11)
- * xcb-util-0.3.3 (2009-01-31)
- * libev
- * asciidoc >= 8.3.0 for docs/hacking-howto
- * asciidoc, xmlto, docbook-xml for man/i3.man
- * Xlib, the one that comes with your X-Server
+ i3 has the following dependencies:
 
-Recommendations:
- * i3lock for locking your screen
- * dmenu for launching applications
+   "min" means minimum required version
+   "lkgv" means last known good version
 
-Get the libraries from:
-http://xcb.freedesktop.org/dist/xcb-proto-1.5.tar.bz2
-http://xcb.freedesktop.org/dist/libxcb-1.1.93.tar.bz2
-http://xcb.freedesktop.org/dist/xcb-util-0.3.5.tar.bz2
-http://libev.schmorp.de/
+┌──────────────┬────────┬────────┬─────────────────────────────────────────────────────────────┐
+│ dependency   │ min.   │ lkgv   │ URL                                                         │
+├──────────────┼────────┼────────┼─────────────────────────────────────────────────────────────┤
+│ pkg-config   │ 0.25   │ 0.29   │ https://pkgconfig.freedesktop.org/                          │
+│ libxcb       │ 1.1.93 │ 1.12   │ https://xcb.freedesktop.org/dist/                           │
+│ xcb-util     │ 0.3.3  │ 0.4.1  │ https://xcb.freedesktop.org/dist/                           │
+│ xkbcommon    │ 0.4.0  │ 0.6.1  │ https://xkbcommon.org/                                      │
+│ xkbcommon-x11│ 0.4.0  │ 0.6.1  │ https://xkbcommon.org/                                      │
+│ util-cursor³⁴│ 0.0.99 │ 0.1.3  │ https://xcb.freedesktop.org/dist/                           │
+│ util-wm⁴     │ 0.3.8  │ 0.3.8  │ https://xcb.freedesktop.org/dist/                           │
+│ util-keysyms⁴│ 0.3.8  │ 0.4.0  │ https://xcb.freedesktop.org/dist/                           │
+│ util-xrm⁴    │ 1.0.0  │ 1.0.0  │ https://github.com/Airblader/xcb-util-xrm/                  │
+│ libev        │ 4.0    │ 4.19   │ http://libev.schmorp.de/                                    │
+│ yajl         │ 2.0.1  │ 2.1.0  │ https://lloyd.github.com/yajl/                              │
+│ asciidoc     │ 8.3.0  │ 8.6.9  │ http://www.methods.co.nz/asciidoc/                          │
+│ xmlto        │ 0.0.23 │ 0.0.23 │ http://www.methods.co.nz/asciidoc/                          │
+│ Pod::Simple² │ 3.22   │ 3.22   │ http://search.cpan.org/dist/Pod-Simple/                     │
+│ docbook-xml  │ 4.5    │ 4.5    │ http://www.methods.co.nz/asciidoc/                          │
+│ PCRE         │ 8.12   │ 8.38   │ https://www.pcre.org/                                       │
+│ libsn¹       │ 0.10   │ 0.12   │ https://freedesktop.org/wiki/Software/startup-notification/ │
+│ pango        │ 1.30.0 │ 1.40.1 │ http://www.pango.org/                                       │
+│ cairo        │ 1.14.4 │ 1.14.6 │ https://cairographics.org/                                  │
+└──────────────┴────────┴────────┴─────────────────────────────────────────────────────────────┘
+ ¹ libsn = libstartup-notification
+ ² Pod::Simple is a Perl module required for converting the testsuite
+   documentation to HTML. See https://michael.stapelberg.de/cpan/#Pod::Simple
+ ³ xcb-util-cursor, to be precise.
+ ⁴ Depending on your distribution, this might be considered part of xcb-util.
 
-http://i3.zekjur.net/i3lock/
-http://tools.suckless.org/dmenu
+ i3bar, i3-msg, i3-input, i3-nagbar and i3-config-wizard do not introduce any
+ new dependencies.
+
+ i3-migrate-config-to-v4 and i3-dmenu-desktop are implemented in Perl, but have
+ no dependencies besides Perl 5.10.
+
+ i3-save-tree is also implemented in Perl and needs AnyEvent::I3 (>= 0.12) and
+ JSON::XS. While i3-save-tree is not required for running i3 itself, it is
+ strongly recommended to provide it in distribution packages.