diff --git a/FAQ.asciidoc b/FAQ.asciidoc index ca9ca6e68..16d02cfa0 100644 --- a/FAQ.asciidoc +++ b/FAQ.asciidoc @@ -112,10 +112,10 @@ Experiencing segfaults (crashes) on Debian systems.:: Segfaults on Facebook, Medium, Amazon, ...:: If you are on a Debian or Ubuntu based system, you might experience some crashes - visting these sites. This is caused by a known bug in Qt which has been + visting these sites. This is caused by various bugs in Qt which have been fixed in Qt 5.4. However Debian and Ubuntu are slow to adopt or upgrade - some packages. There is currently no easy way to manually upgrade to Qt - 5.4 on those systems. + some packages. On Debian Jessie, it's recommended to use the experimental + repos as described in https://github.com/The-Compiler/qutebrowser/blob/master/INSTALL.asciidoc#on-debian--ubuntu[INSTALL]. + Since Ubuntu Trusty (using Qt 5.2.1), https://bugreports.qt.io/browse/QTBUG-42417?jql=component%20%3D%20WebKit%20and%20resolution%20%3D%20Done%20and%20fixVersion%20in%20(5.3.0%2C%20%225.3.0%20Alpha%22%2C%20%225.3.0%20Beta1%22%2C%20%225.3.0%20RC1%22%2C%205.3.1%2C%205.3.2%2C%205.4.0%2C%20%225.4.0%20Alpha%22%2C%20%225.4.0%20Beta%22%2C%20%225.4.0%20RC%22)%20and%20priority%20in%20(%22P2%3A%20Important%22%2C%20%22P1%3A%20Critical%22%2C%20%22P0%3A%20Blocker%22)[over diff --git a/INSTALL.asciidoc b/INSTALL.asciidoc index 90d90fdd9..a35e18e6a 100644 --- a/INSTALL.asciidoc +++ b/INSTALL.asciidoc @@ -12,6 +12,39 @@ qutebrowser should run on these systems: Install the dependencies via apt-get: +[NOTE] +========================== +On Debian, it's recommended to install the Qt packages from the +https://wiki.debian.org/DebianExperimental[experimental] repository as those +are a much newer version of Qt which is more stable. + +Add the following line to your `/etc/apt/sources.list`: + +---- +deb http://ftp.debian.org/debian experimental main +---- + +Then install the packages like this: + +---- +# apt-get update +# apt-get install -t experimental python3-pyqt5 python3-pyqt5.qtwebkit +# apt-get install python-tox +---- + +It's also recommended to pin those packages to receive updates by creating a +file `/etc/apt/preferences.d/qutebrowser` with the following contents: + +---- +Package: python3-pyqt5* libqt5* +Pin: release a=experimental +Pin-Priority: 800 +---- +========================== + +For distributions other than Debian or if you prefer to not use the +experimental repo: + ---- # apt-get install python3-pyqt5 python3-pyqt5.qtwebkit python-tox ----