From d7460160be05d4d4680936b6785f39b3360571ba Mon Sep 17 00:00:00 2001
From: "Steffen (Daode) Nurpmeso" <steffen@sdaoden.eu>
Date: Fri, 14 Oct 2016 17:22:02 +0200
Subject: [PATCH] nail.1: short review of the terminal/MLE section

---
 nail.1 | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

diff --git a/nail.1 b/nail.1
index 5182f6b3..1a0cda79 100644
--- a/nail.1
+++ b/nail.1
@@ -2274,7 +2274,11 @@ and
 .Pp
 The MLE supports a set of editing and control commands.
 By default (as) many (as possible) of these will be assigned to a set of
-single-letter control codes, which should work on any terminal.
+single-letter control codes, which should work on any terminal (and can
+be generated by holding the
+.Dq control
+key while pressing the key of desire, e.g.,
+.Ql control-D ) .
 If the \*(OPal
 .Ic bind
 command is available then the MLE commands can also be accessed freely
@@ -2287,8 +2291,7 @@ an action which can then be suppressed completely by setting
 .Va line-editor-no-defaults .
 The following uses the
 .Xr sh 1 Ns
-ell-style quote notation that is documented in the introductional
-section of
+ell-style quote notation that is documented in the introduction of
 .Sx COMMANDS ;
 combinations not mentioned either cause job control signals or don't
 generate a (unique) keycode:
@@ -2597,8 +2600,8 @@ and the following character is treated literally as part of the argument.
 Some commands which don't take message-list arguments can also be
 prefixed with the special keyword
 .Ic \&\&wysh
-to choose \*(INible behaviour, and some new commands support only the
-new quoting style (without that keyword) and are flagged \*(NQ.
+to choose \*(INible argument quoting rules, and some new commands only
+support the new rules (without that keyword) and are flagged \*(NQ.
 In the future \*(UA will (mostly) use
 .Xr sh 1
 compatible argument parsing:
@@ -2606,7 +2609,7 @@ Non-message-list arguments can be quoted using the following shell-style
 mechanisms: the escape character, single-quotes, double-quotes and
 dollar-single-quotes; any unquoted number sign
 .Ql #
-starts a comment that ends argument processing.
+that parses as a new token starts a comment that ends argument processing.
 The overall granularity of error reporting and diagnostics, also
 regarding function arguments and their content, will improve.
 .
@@ -2686,9 +2689,8 @@ double quote (escaping is optional).
 .It Ql \eNNN
 eight-bit byte with the octal value
 .Ql NNN
-(one to three octal digits), optionally with an additional
-.Ql 0
-suffix.
+(one to three octal digits), optionally prefixed by an additional
+.Ql 0 .
 A 0 byte will suppress further output for the quoted argument.
 .It Ql \exHH
 eight-bit byte with the hexadecimal value
@@ -2759,13 +2761,11 @@ Before \*(UA will switch entirely to shell-style argument parsing there
 will be a transition phase where using
 .Ic \&\&wysh
 will emit obsoletion warnings.
-E.g., the following are equivalent:
 .
 .Bd -literal -offset indent
-mlist @any\e\e.where\e\e.example\e\e.com
-wysh mlist '@any\e.where\e.example\e.com' # This is a comment
-wysh mlist $'@any\e\e\ex2Ewhere\e\e.example\e\e\e56com' # A comment
-wysh mlist "@any\e.where\e.example\e.com"
+echo 'Quotes '${HOME}' and 'tokens" differ!"# no comment
+echo Quotes ${HOME} and tokens differ! # comment
+echo Don"'"t you worry$'\ex21' The sun shines on us. $'\eu263A'
 .Ed
 .
 .Pp
@@ -3021,7 +3021,7 @@ Note that the entire comma-separated list is first parsed (over) as a
 shell-token with whitespace as the field separator, before being parsed
 and expanded for real with comma as the field separator, therefore
 whitespace needs to be properly quoted:
-shell-style quoting is documented in the introductional section of
+shell-style quoting is documented in the introduction of
 .Sx COMMANDS .
 Using Unicode reverse solidus escape sequences renders a binding
 defunctional if the locale doesn't support Unicode (see
@@ -3039,7 +3039,7 @@ See the respective manual for a list of capabilities.
 The program
 .Xr infocmp 1
 can be used to show all the capabilities of
-.Ev $TERM
+.Ev TERM
 or the given terminal type;
 using the
 .Fl \&\&x
-- 
2.11.4.GIT