On Sat, Feb 03, 2018 at 10:28:20PM +0100, Ingo Schwarze wrote: > > > 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 >
pretty much ok me. but: > > 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. as-is, i'd add a comma after "non-standard". but i wonder if we'd be better just saying "... get out of split-screen mode." and running for cover? the comment might draw less attention to itself that way. your call. ok either way, with exusage fix-up or removal. jmc > .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