From 27f4fb4c276024759f7fe2439f5113216ae7987c Mon Sep 17 00:00:00 2001
From: Simon Lydell <simon.lydell@gmail.com>
Date: Sun, 9 Oct 2016 11:34:04 +0200
Subject: [PATCH] Improve documentation on re-mapping `<escape>`

Refs. #823.
---
 documentation/questions-and-answers.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/documentation/questions-and-answers.md b/documentation/questions-and-answers.md
index d8c49bc..a9ea975 100644
--- a/documentation/questions-and-answers.md
+++ b/documentation/questions-and-answers.md
@@ -86,6 +86,14 @@ Or, if you’d like to you both `<escape>` _and_ something else:
 
 [`<force>`]: shortcuts.md#force
 
+## Re-mapping Escape doesn’t always work!
+
+There are several default shortcuts which use `<escape>`. Apart from the Normal
+mode command for blurring text inputs, the Caret, Hints, Find and Marks modes
+have one command each for returning to Normal mode. All of these use `<escape>`.
+
+Perhaps you forgot to re-map some of them?
+
 ## Going back/forward doesn’t work!
 
 Pressing `H` is like hitting the back button. Use `L` for the forward button.
-- 
2.39.3