From ea45eb126165a65605275a09d4783e4e467d3018 Mon Sep 17 00:00:00 2001 From: Florian Bruhin Date: Wed, 17 Jul 2019 19:06:12 +0200 Subject: Update install instructions Fixes #4899 --- doc/install.asciidoc | 39 +++++++-------------------------------- 1 file changed, 7 insertions(+), 32 deletions(-) diff --git a/doc/install.asciidoc b/doc/install.asciidoc index 961579564..7daca11d8 100644 --- a/doc/install.asciidoc +++ b/doc/install.asciidoc @@ -3,31 +3,12 @@ Installing qutebrowser toc::[] -NOTE: qutebrowser recently had some bigger dependency changes for v1.0.0, which -means those instructions might be out of date in some places. -https://github.com/qutebrowser/qutebrowser/blob/master/doc/contributing.asciidoc[Please help] -updating them if you notice something being broken! - On Debian / Ubuntu ------------------ How to install qutebrowser depends a lot on the version of Debian/Ubuntu you're running. -Debian Jessie / Ubuntu 14.04 LTS / Linux Mint < 18 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Those distributions only have Python 3.4 and a too old Qt version available, -while qutebrowser requires Python 3.5 and Qt 5.7.1 or newer. - -It should be possible to install Python 3.5 e.g. from the -https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa[deadsnakes PPA] or via -https://github.com/pyenv/pyenv[pyenv], but nobody tried that yet. - -If you get qutebrowser running on those distributions, please -https://github.com/qutebrowser/qutebrowser/blob/master/doc/contributing.asciidoc[contribute] -to update this documentation! - Ubuntu 16.04 LTS / Linux Mint 18 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -41,10 +22,10 @@ You'll need some basic libraries to use the tox-installed PyQt: # apt install libglib2.0-0 libgl1 libfontconfig1 libx11-xcb1 libxi6 libxrender1 libdbus-1-3 ---- -Debian Stretch / Ubuntu 17.04 and 17.10 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Debian Stretch +~~~~~~~~~~~~~~ -Those versions come with QtWebEngine in the repositories. This makes it possible +Debian Stretch comes with QtWebEngine in the repositories. This makes it possible to install qutebrowser via the Debian package. You'll need to download three packages: @@ -68,11 +49,11 @@ downloaded qutebrowser deb files in one apt command): For an update after the initial install, you only need to download/install the qutebrowser package. -Debian Testing / Ubuntu 18.04 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Debian Buster / Ubuntu 18.04 LTS / Linux Mint 19 (or newer) +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -On Debian Testing, qutebrowser is in the official repositories, and you can -install it with apt: +With those distributions, qutebrowser is in the official repositories, and you +can install it with apt: ---- # apt install qutebrowser @@ -153,18 +134,12 @@ If video or sound don't work with QtWebKit, try installing the gstreamer plugins On Gentoo --------- -NOTE: Gentoo's packages used to be severely outdated for a long time, but are -now (October 2017) maintained and up-to-date again. - qutebrowser is available in the main repository and can be installed with: ---- # emerge -av qutebrowser ---- -To use QtWebKit instead of QtWebEngine, you'll need a newer QtWebKit using -https://gist.github.com/annulen/309569fb61e5d64a703c055c1e726f71[this ebuild]. - If video or sound don't work with QtWebKit, try installing the gstreamer plugins: -- cgit v1.2.3-54-g00ecf