summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFlorian Bruhin <me@the-compiler.org>2020-07-09 10:14:39 +0200
committerFlorian Bruhin <me@the-compiler.org>2020-07-09 10:14:39 +0200
commit6e7bb038fdab304eb3b93dfbb57a49a48ccca287 (patch)
tree26c45a86db8e509695cc24e5226ca7cb8489c96a
parent858a6e32685c35fcef1eab960ccd7aea46824a0e (diff)
downloadqutebrowser-6e7bb038fdab304eb3b93dfbb57a49a48ccca287.tar.gz
qutebrowser-6e7bb038fdab304eb3b93dfbb57a49a48ccca287.zip
doc: Update install instructions
-rw-r--r--doc/install.asciidoc31
1 files changed, 31 insertions, 0 deletions
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 <<tox,in a virtualenv>> 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 <<tox,install qutebrowser in a virtualenv>> instead, which
+is one of the officially maintained options and will always be up-to-date.
+
On FreeBSD
----------