Update compilation instructions throughout our docs
related to https://github.com/i3/i3/issues/4086
Michael Stapelberg authored 3 years ago
Michael Stapelberg committed 3 years ago
20 | 20 | If your distribution has a mechanism to get the preferred terminal, such as the |
21 | 21 | x-terminal-emulator symlink in Debian, please use it in i3-sensible-terminal. |
22 | 22 | |
23 | On debian, compilation and installing the manpages looks like this: | |
23 | You can build i3 like you build any other software package which uses | |
24 | https://mesonbuild.com/; see | |
25 | https://mesonbuild.com/Quick-guide.html#compiling-a-meson-project | |
26 | In case you’re unfamiliar: | |
24 | 27 | |
25 | autoreconf -fi | |
26 | mkdir -p build && cd build | |
27 | ../configure | |
28 | make -j8 install | |
28 | $ mkdir -p build && cd build | |
29 | $ meson .. | |
30 | $ ninja | |
29 | 31 | |
30 | 32 | Please make sure that i3-migrate-config-to-v4 and i3-config-wizard are |
31 | 33 | installed with i3. The Perl script is necessary to (automatically) convert v3 |
34 | 36 | start of i3 (it will automatically exit if it finds a config file). |
35 | 37 | |
36 | 38 | If you have any questions, ideas, hints, problems or whatever, please do not |
37 | hesitate to contact me. I will help you out. Just drop me an E-Mail (find the | |
38 | address at https://michael.stapelberg.de/Impressum/, scroll down to bottom), | |
39 | contact me using the same address in jabber or ask on our IRC channel: | |
40 | (#i3 on irc.freenode.net). | |
39 | hesitate to contact me. I will help you out. Please see | |
40 | https://i3wm.org/contact/ | |
41 | 41 | |
42 | 42 | Thanks again for your efforts, |
43 | 43 | Michael |
22 | 22 | |
23 | 23 | == Building i3 |
24 | 24 | |
25 | You can build i3 like you build any other software package which uses meson. | |
26 | Here’s a memory refresher: | |
25 | You can build i3 like you build any other software package which uses | |
26 | https://mesonbuild.com/[The Meson Build system]; see | |
27 | https://mesonbuild.com/Quick-guide.html#compiling-a-meson-project[Quickstart | |
28 | Guide → Compiling a Meson project]. In case you’re unfamiliar: | |
27 | 29 | |
28 | 30 | $ mkdir -p build && cd build |
29 | 31 | $ meson .. |
119 | 119 | --------------------------------------- |
120 | 120 | $ cd ~/i3 |
121 | 121 | |
122 | $ autoreconf -fi | |
123 | ||
124 | 122 | $ mkdir -p build && cd build |
125 | 123 | |
126 | $ ../configure | |
127 | ||
128 | $ make -j8 | |
124 | $ meson .. | |
125 | ||
126 | $ ninja | |
129 | 127 | # output omitted because it is very long |
130 | 128 | |
131 | 129 | $ cd testcases |
182 | 180 | --------------------------------------- |
183 | 181 | $ cd ~/i3 |
184 | 182 | |
185 | $ autoreconf -fi | |
186 | ||
187 | 183 | $ mkdir -p build && cd build |
188 | 184 | |
189 | $ ../configure | |
190 | ||
191 | $ make -j8 | |
185 | $ meson .. | |
186 | ||
187 | $ ninja | |
192 | 188 | # output omitted because it is very long |
193 | 189 | |
194 | 190 | $ make check |