Merge remote-tracking branch 'Screwtapello/document-mark-registers'
This commit is contained in:
commit
170c4a9cf1
|
@ -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*, *<a-p>*, *<P>*, *<a-P>*, *R* and *<a-R>*
|
||||
(see <<keys#changes, `:doc keys changes`>>)
|
||||
|
||||
*/* (slash)::
|
||||
default search / regex register, used by:
|
||||
*/*, *<a-/>*, *?*, *<a-?>*, *n*, *<a-n>*, *N*, *<a-N>*, ***, *<a-*>*,
|
||||
*s*, *S*, *<a-k>* and *<a-K>*
|
||||
(see <<keys#searching, `:doc keys searching`>>)
|
||||
|
||||
*@* (arobase)::
|
||||
default macro register, used by:
|
||||
*q* and *Q*
|
||||
(see <<keys#macros, `:doc keys macros`>>)
|
||||
|
||||
*^* (caret)::
|
||||
default mark register, used by:
|
||||
*z*, *<a-z>*, *Z* and *<a-Z>*
|
||||
(see <<keys#marks, `:doc keys marks`>>
|
||||
and <<registers#marks, `:doc registers marks`>>)
|
||||
|
||||
*|* (pipe)::
|
||||
default shell command register, used by commands that spawn a subshell:
|
||||
*|*, *<a-|>*, *!* and *<a-!>*
|
||||
(see <<keys#changes-through-external-programs, `:doc keys changes-through-external-programs`>>)
|
||||
|
||||
== 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
|
||||
<<keys#marks, `:doc keys marks`>>), the selections are stored as a list of
|
||||
spans, in a format similar to `%val{selections_desc}` (see
|
||||
<<expansions#value-expansions, `:doc expansions value-expansions`). However,
|
||||
the very first item of the list is of the form:
|
||||
|
||||
---------------------
|
||||
/path/to/file@123@456
|
||||
---------------------
|
||||
|
||||
...where:
|
||||
|
||||
/path/to/file::
|
||||
represents the filesystem path of the file where the selections were saved,
|
||||
like `%val{buffile}`.
|
||||
|
||||
123::
|
||||
represents the value of `%val{timestamp}` when the selections were saved,
|
||||
so the selections can still be restored after the buffer has been modified,
|
||||
or modifications undone.
|
||||
|
||||
456::
|
||||
indicates which was the main selection, when the selections were saved
|
||||
(zero-based).
|
||||
|
||||
You can examine the content of a mark register by using `<a-p>` to paste it,
|
||||
so you can see all its items, not limited to the current number of selections.
|
||||
|
|
Loading…
Reference in New Issue
Block a user