diff options
author | Florian Bruhin <git@the-compiler.org> | 2017-10-12 09:10:41 +0200 |
---|---|---|
committer | Florian Bruhin <git@the-compiler.org> | 2017-10-12 09:12:39 +0200 |
commit | 5905b27299efeaefca04962078dd91f6afcbfd20 (patch) | |
tree | 9c05a3328dd7b4f80054347af47cfd46df7d09e3 /doc/install.asciidoc | |
parent | 5dca8cc8e570949590a43adcca3b8b607bffddcc (diff) | |
download | qutebrowser-5905b27299efeaefca04962078dd91f6afcbfd20.tar.gz qutebrowser-5905b27299efeaefca04962078dd91f6afcbfd20.zip |
Update changelog and install docs for v1.0.0
Diffstat (limited to 'doc/install.asciidoc')
-rw-r--r-- | doc/install.asciidoc | 68 |
1 files changed, 15 insertions, 53 deletions
diff --git a/doc/install.asciidoc b/doc/install.asciidoc index 81a16121c..de6e9f2f2 100644 --- a/doc/install.asciidoc +++ b/doc/install.asciidoc @@ -44,7 +44,7 @@ to install qutebrowser via the Debian package. Install the dependencies via apt-get: ---- -# apt install python-tox python3-{lxml,pyqt5,sip,jinja2,pygments,yaml} python3-pyqt5.qt{webengine,quick,opengl,sql} libqt5sql5-sqlite +# apt install python-tox python3-{lxml,pyqt5,sip,jinja2,pygments,yaml,attr} python3-pyqt5.qt{webengine,quick,opengl,sql} libqt5sql5-sqlite ---- Get the qutebrowser package from the @@ -89,7 +89,8 @@ qutebrowser is available in the official repositories for Fedora 22 and newer. ---- It's also recommended to install `python3-qt5-webengine` and start with `--backend -webengine` to use the new backend. +webengine` to use the new backend. v1.0.0 (which is not in the Fedora repos +currently) uses QtWebEngine by default. On Archlinux ------------ @@ -100,10 +101,6 @@ qutebrowser is available in the official [community] repository. # pacman -S qutebrowser ---- -Archlinux packages an updated `qt5-webkit` package by default. If you want to -use the QtWebEngine backend instead, install `qt5-webengine` and start with -`--backend webengine`. - There is also a -git version available in the AUR: https://aur.archlinux.org/packages/qutebrowser-git/[qutebrowser-git]. @@ -128,45 +125,14 @@ If video or sound don't work with QtWebKit, try installing the gstreamer plugins On Gentoo --------- -WARNING: The Gentoo packages (even the live version) are lagging behind a lot, which means those instructions probably won't work anymore. Until things are looking better, it's recommended to <<tox,install qutebrowser via tox>>. - -A version of qutebrowser is available in the main repository and can be installed with: - ----- -# emerge -av qutebrowser ----- - -However it is suggested to install the Live version (-9999) to take advantage -of the newest features introduced. - -First of all you need to edit your package.accept_keywords file to accept the live -version: - ----- -# nano /etc/portage/package.accept_keywords ----- - -And add the following line to it: - - =www-client/qutebrowser-9999 ** - -Save the file and then install qutebrowser via - ----- -# emerge -av qutebrowser ----- - -Or rebuild your system if you already installed it. - -To update to the last Live version, remember to do - ----- -# emerge -uDNav @live-rebuild @world ----- +The Gentoo packages (even the live version) are lagging behind a lot and are +effectively unmaintained. If you want to create and maintain an official +qutebrowser overlay for Gentoo, please mailto:mail@qutebrowser.org[get in +touch.] -To include qutebrowser among the updates. +It's recommended to <<tox,install qutebrowser via tox>> instead. -You'll also need to install `dev-qt/qtwebengine` or a newer QtWebKit using +To get an up-to-date QtWebKit, you can use https://gist.github.com/annulen/309569fb61e5d64a703c055c1e726f71[this ebuild]. If video or sound don't work with QtWebKit, try installing the gstreamer @@ -182,7 +148,6 @@ need to turn off the `bindist` flag for `dev-qt/qtwebengine`. See the https://wiki.gentoo.org/wiki/Qutebrowser#USE_flags[Gentoo Wiki] for more information. - On Void Linux ------------- @@ -197,6 +162,8 @@ It's currently recommended to install `python3-PyQt5-webengine` and `python3-PyQt5-opengl`, then start with `--backend webengine` to use the new backend. +Since the v1.0 release, qutebrowser uses QtWebEngine by default. + On NixOS -------- @@ -210,6 +177,8 @@ $ nix-env -i qutebrowser It's recommended to install `qt5.qtwebengine` and start with `--backend webengine` to use the new backend. +Since the v1.0 release, qutebrowser uses QtWebEngine by default. + On openSUSE ----------- @@ -313,20 +282,13 @@ $ brew install qt5 $ pip3 install qutebrowser ---- +Since the v1.0 release, qutebrowser uses QtWebEngine by default. + Homebrew's builds of Qt and PyQt don't come with QtWebKit (and `--with-qtwebkit` uses an old version of QtWebKit which qutebrowser doesn't support anymore). If you want QtWebKit support, you'll need to build an up-to-date QtWebKit https://github.com/annulen/webkit/wiki/Building-QtWebKit-on-OS-X[manually]. -QtWebKit support, it is necessary to build from source. The build takes several -hours on an average laptop. - ----- -$ brew install qt5 --with-qtwebkit -$ brew install -s pyqt5 -$ pip3 install qutebrowser ----- - Packagers --------- |