diff --git a/doc/pages/registers.asciidoc b/doc/pages/registers.asciidoc index f6ce7f4b..db4b46fe 100644 --- a/doc/pages/registers.asciidoc +++ b/doc/pages/registers.asciidoc @@ -4,7 +4,8 @@ Registers are named lists of text -instead of simply text- in order to interact well with multiselection. They are used for various purposes, like storing -the last yanked text, or the captured groups associated with the selections. +yanked text, the locations of selections in a buffer, or groups captured by a +regular expression. == Interacting @@ -27,23 +28,29 @@ All normal-mode commands using a register default to a specific one if not speci *"* (dquote):: default delete / copy / paste / replace register, used by: *c*, *d*, *y*, *p*, **, *

*, **, *R* and ** + (see <>) */* (slash):: default search / regex register, used by: */*, **, *?*, **, *n*, **, *N*, **, ***, **, *s*, *S*, ** and ** + (see <>) *@* (arobase):: default macro register, used by: *q* and *Q* + (see <>) *^* (caret):: default mark register, used by: *z*, **, *Z* and ** + (see <> + and <>) *|* (pipe):: default shell command register, used by commands that spawn a subshell: *|*, **, *!* and ** + (see <>) == Special registers @@ -76,3 +83,33 @@ month in register *3*, but select the entire date: -------------------- (\w+) (\w+) (\d+) .+ -------------------- + +== Marks + +When a register is used to store a set of selections with the *Z* key (see +<>), the selections are stored as a list of +spans, in a format similar to `%val{selections_desc}` (see +<` to paste it, +so you can see all its items, not limited to the current number of selections.