Recommend using distro packages

There were too many people with LGI-related problems lately. Figuring
out these problems takes a lot of time which we can spend better on
other things.

Signed-off-by: Uli Schlachter <psychon@znc.in>

download.mdwn

@@ -27,7 +27,23 @@
 
  * [GoboLinux](gobolinux.org)
 
-## Stable
+## Building from Source
+
+<p class="standout">
+We strongly recommend using the awesome package of your distribution.
+</p>
+
+This is because many people who tried to build from source had problems.
+[LGI](https://github.com/pavouk/lgi), one of awesome's dependencies, currently
+hardcodes the package search path used by Lua 5.1. Part of the reason for this
+is that Lua upstream intends Lua to be embedded, which means that detecting an
+installed Lua version properly is not easy.
+
+After installing awesome, you can check if you are affected by this problem by
+running `awesome -v`. If an error message is displayed instead of LGI version's
+number, you are likely affected.
+
+### Stable
 
 Latest stable version of **awesome** is version 4.1 (*Technologic*)
 released on 18 March 2017.
@@ -36,7 +52,7 @@ released on 18 March 2017.
 * [awesome-4.1.tar.bz2](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-4.1.tar.bz2) ([GPG sig](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-4.1.tar.bz2.asc))
 * [awesome-4.1.tar.xz](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-4.1.tar.xz) ([GPG sig](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-4.1.tar.xz.asc))
 
-## Old stable
+### Old stable
 
 This branch of **awesome** is deprecated.
 
@@ -47,7 +63,7 @@ released on 6 March 2016.
 * [awesome-3.5.9.tar.bz2](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-3.5.9.tar.bz2)
 * [awesome-3.5.9.tar.xz](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-3.5.9.tar.xz)
 
-## Development
+### Development
 
 The Git repository can be cloned from Github: