diff options
| author | Larry Hynes <larry@larryhynes.com> | 2017-06-23 17:42:50 +0100 |
|---|---|---|
| committer | Herbert Xu <herbert@gondor.apana.org.au> | 2018-03-10 16:01:42 +0800 |
| commit | 68dac4c5806438214708b5a3c08cc1585e12a7ae (patch) | |
| tree | 6b9927adbb3c5cc57f63e76dde4fb603f908867c | |
| parent | builtin: describe_command - fix incorrect path (diff) | |
| download | dash-68dac4c5806438214708b5a3c08cc1585e12a7ae.tar.gz dash-68dac4c5806438214708b5a3c08cc1585e12a7ae.zip | |
man: Small cleanup for Command Line Editing
Jilles Tjoelker <jilles@stack.nl> 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 <ESC> 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 <ESC> 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 <herbert@gondor.apana.org.au>
| -rw-r--r-- | src/dash.1 | 7 |
1 files 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. |