From 6022fd2b2616e5008fab8b75503aa70fc16b13fa Mon Sep 17 00:00:00 2001
From: Florian Bruhin <git@the-compiler.org>
Date: Sat, 9 Jun 2018 21:56:56 +0200
Subject: [PATCH] Document how to run a qutebrowser development build

Fixes #3795
Supersedes #3798
---
 doc/contributing.asciidoc | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/contributing.asciidoc b/doc/contributing.asciidoc
index 458b9b744..3845dfdf7 100644
--- a/doc/contributing.asciidoc
+++ b/doc/contributing.asciidoc
@@ -85,6 +85,16 @@ git format-patch origin/master <1>
 <1> Replace `master` by the branch your work was based on, e.g.,
 `origin/develop`.
 
+Running qutebrowser
+-------------------
+
+After link:install.asciidoc#tox[installing qutebrowser via tox], you can run
+`.venv/bin/qutebrowser --debug --temp-basedir` to test your changes with debug
+logging enabled and without affecting existing running instances.
+
+Alternatively, you can install qutebrowser's dependencies system-wide and run
+`python3 -m qutebrowser --debug --temp-basedir`.
+
 Useful utilities
 ----------------