Hi Jason, Jason McIntyre wrote on Sat, Feb 03, 2018 at 08:52:16PM +0000:
> hmm. not that i entirely agree with this sentiment but fair enough, > i will look at updating the USD docs. Thanks. Don't waste your time on that until after commit, of course. > a good way to do it without adding verbiage would be to not document it! > if it really is a crappy quirk, let's just leave it out then. I actually like that idea, it makes the long list of EX COMMANDS a bit simpler, making the relevant stuff easier to find. Of course, we still have to say how to get out of split screen mode when you stumble into it unintentionally - which esily happens because the colon requires the shift key on many keyboards, so accidentally hitting ":N" instead of ":n" is not uncommon. If people like the idea, i'll also fix up :exusage (unless people want :exusage deleted, which i would of course prefer). OK? Ingo Index: vi.1 =================================================================== RCS file: /cvs/src/usr.bin/vi/docs/USD.doc/vi.man/vi.1,v retrieving revision 1.74 diff -u -p -r1.74 vi.1 --- vi.1 22 Aug 2017 20:27:18 -0000 1.74 +++ vi.1 3 Feb 2018 21:14:48 -0000 @@ -1737,11 +1737,6 @@ The input text is appended after the spe .It Cm ar Ns Op Cm gs Display the argument list. .Pp -.It Cm bg -.Nm vi -only. -Background the current screen. -.Pp .It Xo .Op Ar range .Cm c Ns Op Cm hange Ns @@ -1788,24 +1783,16 @@ Delete the lines from the file. .It Xo .Cm di Ns Op Cm splay .Cm b Ns Oo Cm uffers Oc | -.Cm s Ns Oo Cm creens Oc | .Cm t Ns Op Cm ags .Xc -Display buffers, screens or tags. +Display buffers or tags. .Pp .It Xo -.Op Cm Ee Ns -.Op Cm dit Ns +.Cm e Ns Op Cm dit Ns | Ns Cm x Ns .Op Cm !\& .Op Ar +cmd .Op Ar file .Xc -.It Xo -.Op Cm Ee Ns -.Cm x Ns Op Cm !\& -.Op Ar +cmd -.Op Ar file -.Xc Edit a different file. .Pp .It Xo @@ -1823,15 +1810,6 @@ command. Display and optionally change the file name. .Pp .It Xo -.Op Cm Ff Ns -.Cm g -.Op Ar name -.Xc -.Nm vi -mode only. -Foreground the specified screen. -.Pp -.It Xo .Op Ar range .Cm g Ns Op Cm lobal .No / Ns Ar pattern Ns / @@ -1880,9 +1858,9 @@ Display the lines unambiguously. .Cm map Ns Op Cm !\& .Op Ar lhs rhs .Xc -Define or display maps (for .Nm vi -only). +only. +Define or display maps. .Pp .It Xo .Op Ar line @@ -1912,8 +1890,7 @@ Write the abbreviations, editor options .Ar file . .Pp .It Xo -.Op Cm Nn Ns -.Op Cm ext Ns +.Cm n Ns Op Cm ext Ns .Op Cm !\& .Op Ar file ... .Xc @@ -1933,11 +1910,7 @@ Save the file in a form that can later b .Fl r option. .Pp -.It Xo -.Op Cm \&Pp Ns -.Cm rev Ns Op Cm ious Ns -.Op Cm !\& -.Xc +.It Cm prev Ns Oo Cm ious Oc Ns Op Cm !\& Edit the previous file from the argument list. .Pp .It Xo @@ -1960,6 +1933,8 @@ Append buffer contents to the current li .Op Cm !\& .Xc End the editing session. +This command can also be used to get out of the intentionally +undocumented, non-standard split-screen mode. .Pp .It Xo .Op Ar line @@ -1978,15 +1953,6 @@ Recover if it was previously saved. .Pp .It Xo -.Cm res Ns Op Cm ize -.Op Cm + Ns | Ns Cm - Ns -.Ar size -.Xc -.Nm vi -mode only. -Grow or shrink the current screen. -.Pp -.It Xo .Cm rew Ns Op Cm ind Ns .Op Cm !\& .Xc @@ -2132,8 +2098,7 @@ character is usually .Aq control-Z . .Pp .It Xo -.Op Cm Tt Ns -.Cm a Ns Op Cm g Ns +.Cm ta Ns Op Cm g Ns .Op Cm !\& .Ar tagstring .Xc @@ -2195,19 +2160,18 @@ editor. .Op Ar flags .Xc .Nm ex -mode only. +only. Enter .Nm vi . .Pp .It Xo -.Op Cm Vi Ns -.Cm i Ns Op Cm sual Ns +.Cm vi Ns Op Cm sual Ns .Op Cm !\& .Op Ar +cmd .Op Ar file .Xc .Nm vi -mode only. +only. Edit a new file. .Pp .It Xo @@ -2231,19 +2195,23 @@ command. .Op Cm !\& .Op Ar file .Xc +Write the file. +.Pp .It Xo .Op Ar range .Cm wn Ns Op Cm !\& .Op >> .Op Ar file .Xc +Write the file and edit the next file from the argument list. +.Pp .It Xo .Op Ar range .Cm wq Ns Op Cm !\& .Op >> .Op Ar file .Xc -Write the file. +Write the file and exit the editor. .Pp .It Xo .Op Ar range