From 6e7bb038fdab304eb3b93dfbb57a49a48ccca287 Mon Sep 17 00:00:00 2001 From: Florian Bruhin Date: Thu, 9 Jul 2020 10:14:39 +0200 Subject: doc: Update install instructions --- doc/install.asciidoc | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/doc/install.asciidoc b/doc/install.asciidoc index 4355abc7b..0f9a4c399 100644 --- a/doc/install.asciidoc +++ b/doc/install.asciidoc @@ -3,6 +3,24 @@ Installing qutebrowser toc::[] +Official vs. community-maintained +--------------------------------- + +Only the following releases are done by qutebrowser's maintainer directly: + +- Source packages in https://github.com/qutebrowser/qutebrowser/releases[this + GitHub repository] and on https://pypi.org/project/qutebrowser/#files[PyPI] +- Windows and macOS prebuilt binaries in the GitHub Releases +- The `qutebrowser-git` package in the + https://aur.archlinux.org/packages/qutebrowser-git/[Archlinux AUR] +- Installing <> from the git repository. + +All other packaging is done by the community, so in case of outdated/broken +packages, you will need to reach out to the respective maintainers. Note that +some distributions (notably, Debian Stable and Ubuntu) do only update +qutebrowser and the underlying QtWebEngine when there's a new release of the +distribution, typically once all couple of months to years. + On Debian / Ubuntu ------------------ @@ -223,6 +241,19 @@ PYTHON3=yes sbopkg -i qutebrowser If you use the dialog screen you can deselect any already-installed packages that you don't need/want to rebuild before starting the build process. +Via Flatpak +----------- + +qutebrowser is available +https://flathub.org/apps/details/org.qutebrowser.qutebrowser[on Flathub] +as `org.qutebrowser.qutebrowser`. + +WARNING: As of July 2020, the Flatpak package is severely outdated (qutebrowser +v1.7.0 from July 2019) and, among other issues, misses fixes for a +(low-severity) https://github.com/qutebrowser/qutebrowser/security/advisories/GHSA-4rcq-jv2f-898j[security issue]. +It's recommended to <> instead, which +is one of the officially maintained options and will always be up-to-date. + On FreeBSD ---------- -- cgit v1.2.3-54-g00ecf