From d922ae9a932a30c166975206d78d69ad68e902a7 Mon Sep 17 00:00:00 2001
From: Maxime Coste <mawww@kakoune.org>
Date: Wed, 25 Jan 2017 00:14:11 +0000
Subject: [PATCH] Add a quick section on key syntax in keys.asciidoc

---
 doc/manpages/keys.asciidoc | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/manpages/keys.asciidoc b/doc/manpages/keys.asciidoc
index d46864cf..d197a64a 100644
--- a/doc/manpages/keys.asciidoc
+++ b/doc/manpages/keys.asciidoc
@@ -5,6 +5,15 @@ NAME
 ----
 keys - a
 
+Key Syntax
+----------
+Usual keys are written using their ascii character, including capital
+keys. Non printable keys use an alternate name, written between *<*
+and *>*, such as *<esc>* or *<del>*. Modified keys are written between
+*<* and *>* as well, with the modifier specified as either *c* for
+Control, or *a* for Alt, followed by a *-* and the key (either its
+name or ascii character), for example *<c-x>*, *<a-space>*.
+
 Insert mode
 -----------
 *<esc>*::