From d3608bb6ebd44825cabacdafe5cd44bbca475e57 Mon Sep 17 00:00:00 2001
From: Michael Stapelberg <michael@stapelberg.de>
Date: Fri, 7 Aug 2015 08:41:39 +0200
Subject: [PATCH] =?UTF-8?q?userguide:=20explain=20i3-config-wizard?=
 =?UTF-8?q?=E2=80=99s=20behavior?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

fixes #1782
---
 docs/userguide | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/userguide b/docs/userguide
index e2155381..1eb7b3ac 100644
--- a/docs/userguide
+++ b/docs/userguide
@@ -23,6 +23,13 @@ image:keyboard-layer2.png["Keys to use with Shift+$mod",width=600,link="keyboard
 The red keys are the modifiers you need to press (by default), the blue keys
 are your homerow.
 
+Note that when starting i3 without a config file, i3-config-wizard will offer
+you to create a config file in which the key positions (!) match what you see
+in the image above, regardless of the keyboard layout you are using. If you
+prefer to use a config file where the key letters match what you are seeing
+above, just decline i3-config-wizard’s offer and base your config on
++/etc/i3/config+.
+
 == Using i3
 
 Throughout this guide, the keyword +$mod+ will be used to refer to the