'\" t
.\"     Title: kakoune
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 11/16/2018
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH KAK_REGISTERS 1 "" "" "registers"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
registers \- a
.SH "DESCRIPTION"
.sp
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\&.
.SH "INTERACTING"
.PP
\fB<c\-r><c>\fR
.RS 4
when in insert mode or in a prompt, insert the value stored in the
\fBc\fR
register (single character)
.RE
.PP
\fB"<c>\fR
.RS 4
in normal mode, select the
\fB<c>\fR
register (single character)
.RE
.SH "ALTERNATE NAMES"
.sp
non alphanumeric registers have an alternative name that can be used in contexts where only alphanumeric identifiers are possible\&.
.SH "DEFAULT REGISTERS"
.sp
Most commands using a register default to a specific one if not specified:
.PP
\fB"\fR (dquote)
.RS 4
default yank register, used by yanking and pasting commands like
\fBy\fR,
\fBp\fR
and
\fBR\fR
.RE
.PP
\fB/\fR (slash)
.RS 4
default search register, used by regex based commands like
\fBs\fR,
\fB*\fR
or
\fB/\fR
.RE
.PP
\fB@\fR (arobase)
.RS 4
default macro register, used by
\fBq\fR
and
\fBQ\fR
.RE
.PP
\fB^\fR (caret)
.RS 4
default mark register, used by
\fBz\fR
and
\fBZ\fR
.RE
.PP
\fB|\fR (pipe)
.RS 4
default shell command register, used by command that spawn a subshell such as
\fB|\fR,
\fB<a\-|>\fR,
\fB!\fR
or
\fB<a\-!>\fR
.RE
.SH "SPECIAL REGISTERS"
.sp
Some registers are not general purposes, they cannot be written to, but they contain some special data
.PP
\fB%\fR (percent)
.RS 4
current buffer name
.RE
.PP
\fB\&.\fR (dot)
.RS 4
current selection contents
.RE
.PP
\fB#\fR (hash)
.RS 4
selection indices (first selection has 1, second has 2, \&...)
.RE
.PP
\fB_\fR (underscore)
.RS 4
null register, always empty
.RE
.SH "INTEGER REGISTERS"
.sp
Registers \fB1\fR to \fB9\fR hold the grouped sub\-matches of the regular expression used to make the last selection\&. Example: applying the following regular expression to the date of the day would put the day of the week in register \fB1\fR, the month in register \fB2\fR, and the day of the month in register \fB3\fR, but select the entire date:
.sp
.if n \{\
.RS 4
.\}
.nf
(\ew+) (\ew+) (\ed+) \&.+
.fi
.if n \{\
.RE
.\}