From 230605d316d28b0fa8acff7a8a76a5a5b1c91429 Mon Sep 17 00:00:00 2001 From: Evan Gates Date: Wed, 22 Sep 2021 11:02:45 -0700 Subject: 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) --- man/vis.1 | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'man/vis.1') diff --git a/man/vis.1 b/man/vis.1 index 0543366..c5ea229 100644 --- a/man/vis.1 +++ b/man/vis.1 @@ -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 \&| -- cgit v1.2.3