vis-prompt: make it easier to enter multi line commands

<Enter> now searches for lines starting with command delimiters to
find the command boundaries.

To actually enter a literal new line use <Ctrl-v><Enter> in insert
mode or `o` / `O` in normal mode.

Also remove the special <Backspace> mapping, does not seem esential
use <Escape> to close the prompt window.

1 files changed, 24 insertions, 1 deletions

diff --git a/man/vis.1 b/man/vis.1
index 4cc8dff..3e99b54 100644
--- a/man/vis.1
+++ b/man/vis.1
@@ -1,4 +1,4 @@
-.Dd December 5, 2016
+.Dd January 14, 2017
 .Dt VIS 1
 .Os Vis VERSION
 .
@@ -1156,6 +1156,29 @@ permissions or when either the file owner, group, POSIX ACL or SELinux
 labels can not be restored.
 .El
 .
+.Sh COMMAND and SEARCH PROMPT
+.
+The command and search prompt as opened by
+.Ic ":" ,
+.Ic "/" ,
+or
+.Ic "?"
+is implemented as a single line height window, displaying a regular file
+whose editing starts in insert mode.
+.Aq Escape
+switches to normal mode, a second
+.Aq Escape
+cancels the prompt.
+.Aq Up
+enlarges the window, giving access to the command history.
+.Aq C-v
+.Aq Enter
+inserts a literal new line thus enabling multiline commands.
+.Aq Enter
+executes the visual selection if present, or else everything in the
+region spawned by the cursor position and the delimiting prompt symbols
+at the start of adjacent lines.
+.
 .Sh CONFIGURATION
 .
 .Nm