diff options
| author | Evan Gates <evan.gates@gmail.com> | 2021-09-22 11:02:45 -0700 |
|---|---|---|
| committer | Evan Gates <evan.gates@gmail.com> | 2022-06-15 14:26:53 -0600 |
| commit | 230605d316d28b0fa8acff7a8a76a5a5b1c91429 (patch) | |
| tree | 90a8c9b86fbdab22214979702ae96b20462521f6 | |
| parent | 22d4709e8a30c8feb9b4da7d78e0ea6a57af83e8 (diff) | |
| download | vis-230605d316d28b0fa8acff7a8a76a5a5b1c91429.tar.gz vis-230605d316d28b0fa8acff7a8a76a5a5b1c91429.tar.xz | |
man: explicitly document default mark usage
Marks use 'am and 'aM to mirror register usage for yank/put and allow a
default mark when one is not specified. For anyone coming from vim and
used to ma and 'a usage, using a default mark when none is specified is
a foreign concept. This leads to e.g. ''m and ''| when m and | would do.
Explain in the man page that the default mark is used when none is
specified for mark and selection set operations.
[0]: ad10da5 (vis: cleanup marks implementation)
| -rw-r--r-- | man/vis.1 | 12 |
1 files changed, 12 insertions, 0 deletions
@@ -137,6 +137,11 @@ sets the mark while .Ic ' Ns Ar a Ns Ic M restores it. +Use of +.Ic m +or +.Ic M +without specifying a mark uses the default mark. .Pp Available marks are: .Bl -tag -width indent @@ -1158,6 +1163,13 @@ align all selections by inserting spaces Selections can be manipulated using set operations. The first operand is the currently active selections while the second can be specified as a mark. +For example, +.Ic ' Ns Ar a Ns Ic \&| +produces the union of the mark +.Ar a +and the current selection. +Use of set operations without specifying a mark use the default mark as +the first operand. .Pp .Bl -tag -width XXXXXXXXXX -compact .It Ic \&| |