diff --git a/README.asciidoc b/README.asciidoc
index 03368df59..b8f6f7a18 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -837,9 +837,12 @@ You can redefine keys meaning using the map command
 ------------------------------------------------------
 
 with +scope+ being one of +global, buffer or window+ (or any prefix),
-mode being +insert, normal, prompt or menu+ (or any prefix), +key+ being
+mode being +insert, normal, prompt, menu or user+ (or any prefix), +key+ being
 a single key name and +keys+ a list of keys.
 
++user+ mode allows for user mapping behind the +,+ key. Keys will be executed in
+normal mode.
+
 Faces
 -----