diff --git a/doc/install.asciidoc b/doc/install.asciidoc
index 07892c876..42814c74f 100644
--- a/doc/install.asciidoc
+++ b/doc/install.asciidoc
@@ -304,7 +304,11 @@ $ brew install qt5
 $ pip3 install qutebrowser
 ----
 
-Homebrew's builds of Qt and PyQt no longer include QtWebKit - if you need
+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.