From 551d7dfbac20f85425c6dbf96dd93434817e1da8 Mon Sep 17 00:00:00 2001
From: Delapouite <delapouite@gmail.com>
Date: Mon, 28 Oct 2019 22:18:55 +0100
Subject: [PATCH] doc: mention newly introduced `<semicolon>` and
 `<a-semicolon>` keys

Ref: #3156
---
 doc/pages/commands.asciidoc |  5 ++++-
 doc/pages/keys.asciidoc     | 10 +++++-----
 2 files changed, 9 insertions(+), 6 deletions(-)

diff --git a/doc/pages/commands.asciidoc b/doc/pages/commands.asciidoc
index 2ef0f3a98..b3a1cf1b7 100644
--- a/doc/pages/commands.asciidoc
+++ b/doc/pages/commands.asciidoc
@@ -362,7 +362,10 @@ but not really useful in that context.
 
 Commands (c.f. previous sections) can be chained, by being separated either
 by new lines or by semicolons, as such a semicolon must be escaped with a
-backslash (\;) to be considered as a literal semicolon argument
+backslash (\;) to be considered as a literal semicolon argument.
+
+To avoid trouble while writing `map` or `execute-keys` commands in scripts,
+the alternative key namings `<semicolon>` and `<a-semicolon>` can be used.
 
 == Declaring new commands
 
diff --git a/doc/pages/keys.asciidoc b/doc/pages/keys.asciidoc
index d4bba91fc..c1600a3ea 100644
--- a/doc/pages/keys.asciidoc
+++ b/doc/pages/keys.asciidoc
@@ -40,7 +40,7 @@ In order to bind some keys to arbitrary ones, refer to <<mapping#,`:doc mapping`
 *<c-u>*::
     commit changes up to now as a single undo group
 
-*<a-;>*::
+*<a-;>*, *<a-semicolon>*::
     escape to normal mode for a single command
 
 == Insert mode completion
@@ -195,10 +195,10 @@ the Shift modifier and moving will extend each selection instead.
 *<c-d>*::
     scroll half a page down
 
-*;*::
+*;*, *<semicolon>*::
     reduce selections to their cursor
 
-*<a-;>*::
+*<a-;>*, *<a-semicolon>*::
     flip the direction of each selection
 
 *<a-:>*::
@@ -693,7 +693,7 @@ in order to specify the wanted object:
 *c*::
     select user defined object, will prompt for open and close text
 
-*<a-;>*::
+*<a-;>*, *<a-semicolon>*::
     run a command with additional expansions describing the selection
     context (See <<expansions#,`:doc expansions`>>)
 
@@ -797,5 +797,5 @@ The following keys are recognized by this mode to help with editing
     expand the typed expansions in currently entered text
     (See <<expansions#typed-expansions,`:doc expansions typed-expansions`>>)
 
-*<a-;>*::
+*<a-;>*, *<a-semicolon>*::
     escape to normal mode for a single command