From 68dac4c5806438214708b5a3c08cc1585e12a7ae Mon Sep 17 00:00:00 2001 From: Larry Hynes Date: Fri, 23 Jun 2017 17:42:50 +0100 Subject: man: Small cleanup for Command Line Editing MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Jilles Tjoelker wrote: > On Sat, Jun 17, 2017 at 03:53:26PM +0100, Larry Hynes wrote: >> src/dash.1, under Command Line Editing, states: >> It's similar to vi: typing will throw you into command >> VI command mode. >> - There appears to be no need for both occurrences of 'command' >> - I can't see a reason for VI to be capitalised >> - 'will throw you into' seems a little... enthusiastic >> Following diff changes it to >> It's similar to vi: typing enters vi command mode. >> diff --git a/src/dash.1 b/src/dash.1 >> index 8b8026d..f35d89d 100644 >> --- a/src/dash.1 >> +++ b/src/dash.1 >> @@ -2232,7 +2232,7 @@ enabled, sh can be switched between insert mode and command mode. >> The editor is not described in full here, but will be in a later document. >> It's similar to vi: typing >> .Aq ESC >> -will throw you into command VI command mode. >> +enters vi command mode. >> Hitting >> .Aq return >> while in command mode will pass the line to the shell. > I agree. If you're changing things here anyway, I suggest getting rid of > the contraction as well (changing It's to It is). The fairly formal > style of man pages avoids contractions, just like it avoids "you". > The reference to the "later document" can probably be removed as well, > since said document does not exist yet after many years. Hi Revised diff, below, expands the contraction, deletes reference to 'later document' and changes 'place' to 'places' in the following: The command ‘set -o vi’ enables vi-mode editing and place sh into vi insert mode. Signed-off-by: Herbert Xu --- src/dash.1 | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/src/dash.1 b/src/dash.1 index 8b8026d..1056285 100644 --- a/src/dash.1 +++ b/src/dash.1 @@ -2226,13 +2226,12 @@ This mode uses commands, described below, similar to a subset of those described in the vi man page. The command .Ql set -o vi -enables vi-mode editing and place sh into vi insert mode. +enables vi-mode editing and places sh into vi insert mode. With vi-mode enabled, sh can be switched between insert mode and command mode. -The editor is not described in full here, but will be in a later document. -It's similar to vi: typing +It is similar to vi: typing .Aq ESC -will throw you into command VI command mode. +enters vi command mode. Hitting .Aq return while in command mode will pass the line to the shell. -- cgit 1.4.1