xenia/kakoune
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge remote-tracking branch 'Delapouite/current-selection'

Browse Source
This commit is contained in:
Maxime Coste 2018-05-07 21:48:54 +10:00
commit ae2ed21e07
1 changed files with 71 additions and 69 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

140
doc/pages/keys.asciidoc
View File

@ -81,7 +81,7 @@ In normal mode, commands can be prefixed with a numeric count, which can control
the command behaviour. the command behaviour.
For example, *3W* selects 3 consecutive words and *3w* select the third word on For example, *3W* selects 3 consecutive words and *3w* select the third word on
the right of selection end. the right of the end of each selection.
== Disabling Hooks == Disabling Hooks
@ -96,29 +96,29 @@ it when pasting text.
'word' is a sequence of alphanumeric characters or underscore, and 'WORD' 'word' is a sequence of alphanumeric characters or underscore, and 'WORD'
is a sequence of non whitespace characters. Generally, a movement on it own is a sequence of non whitespace characters. Generally, a movement on it own
will move the selection to cover the text moved over, while holding down will move each selection to cover the text moved over, while holding down
the Shift modifier and moving will extend the selection instead. the Shift modifier and moving will extend each selection instead.
*h*, *<left>*:: *h*, *<left>*::
select the character on the left of selection end select the character on the left of the end of each selection
*j*, *<down>*:: *j*, *<down>*::
select the character below the selection end select the character below the end of each selection
*k*, *<up>*:: *k*, *<up>*::
select the character above the selection end select the character above the end of each selection
*l*, *<right>*:: *l*, *<right>*::
select the character on the right of selection end select the character on the right of the end of each selection
*w*:: *w*::
select the word and following whitespaces on the right of selection end select the word and following whitespaces on the right of the end of each selection
*b*:: *b*::
select preceding whitespaces and the word on the left of selection end select preceding whitespaces and the word on the left of the end of each selection
*e*:: *e*::
select preceding whitespaces and the word on the right of selection end select preceding whitespaces and the word on the right of the end of each selection
*<a-[wbe]>*:: *<a-[wbe]>*::
same as [wbe] but select WORD instead of word same as [wbe] but select WORD instead of word
@ -137,7 +137,7 @@ the Shift modifier and moving will extend the selection instead.
in <<options#,`:doc options`>> in <<options#,`:doc options`>>
*x*:: *x*::
select line on which selection end lies (or next line when end lies select line on which the end of each selection lies (or next line when end lies
on an end-of-line) on an end-of-line)
*<a-x>*:: *<a-x>*::
@ -192,17 +192,11 @@ the Shift modifier and moving will extend the selection instead.
*<c-d>*:: *<c-d>*::
scroll half a page down scroll half a page down
*)*::
rotate main selection (the main selection becomes the next one)
*(*::
rotate main selection backward (the main selection becomes the previous one)
*;*:: *;*::
reduce selections to their cursor reduce selections to their cursor
*<a-;>*:: *<a-;>*::
flip the selections direction flip the direction of each selection
*<a-:>*:: *<a-:>*::
ensure selections are in forward direction (cursor after anchor) ensure selections are in forward direction (cursor after anchor)
@ -213,40 +207,42 @@ the Shift modifier and moving will extend the selection instead.
== Changes == Changes
*i*:: *i*::
enter insert mode before current selection enter insert mode before selections
*a*:: *a*::
enter insert mode after current selection enter insert mode after selections
*d*:: *d*::
yank and delete current selection yank and delete selections
*c*:: *c*::
yank and delete current selection and enter insert mode yank and delete selections and enter insert mode
*.*:: *.*::
repeat last insert mode change (*i*, *a*, or *c*, including the repeat last insert mode change (*i*, *a*, or *c*, including the
inserted text) inserted text)
*<a-d>*:: *<a-d>*::
delete current selection (not yanking) delete selections (not yanking)
*<a-c>*:: *<a-c>*::
delete current selection and enter insert mode (not yanking) delete selections and enter insert mode (not yanking)
*I*:: *I*::
enter insert mode at current selection begin line start enter insert mode at the beginning of the lines containing
the start of each selection
*A*:: *A*::
enter insert mode at current selection end line end enter insert mode at the end of the lines containing
the end of each selection
*o*:: *o*::
enter insert mode in a new line (or in a given count of new lines) below enter insert mode in a new line (or in a given count of new lines)
current selection end below the end of each selection
*O*:: *O*::
enter insert mode in a new line (or in a given count of new lines) above enter insert mode in a new line (or in a given count of new lines)
current selection begin above the beginning of each selection
*<a-o>*:: *<a-o>*::
add an empty line below cursor add an empty line below cursor
@ -258,22 +254,22 @@ the Shift modifier and moving will extend the selection instead.
yank selections yank selections
*p*:: *p*::
paste after current selection end paste after the end of each selection
*P*:: *P*::
paste before current selection begin paste before the beginning of each selection
*<a-p>*:: *<a-p>*::
paste all after current selection end, and select each pasted string paste all after the end of each selection, and select each pasted string
*<a-P>*:: *<a-P>*::
paste all before current selection begin, and select each pasted string paste all before the start of each selection, and select each pasted string
*R*:: *R*::
replace current selection with yanked text replace selections with yanked text
*<a-R>*:: *<a-R>*::
replace current selection with every yanked text replace selections with every yanked text
*r*:: *r*::
replace each character with the next entered one replace each character with the next entered one
@ -311,11 +307,11 @@ the Shift modifier and moving will extend the selection instead.
(See <<expansions#shell-expansions,`:doc expansions shell-expansions`>>) (See <<expansions#shell-expansions,`:doc expansions shell-expansions`>>)
*!*:: *!*::
insert command output before selection. Shell expansions are available, insert command output before each selection. Shell expansions are available,
(See <<expansions#shell-expansions,`:doc expansions shell-expansions`>>) (See <<expansions#shell-expansions,`:doc expansions shell-expansions`>>)
*<a-!>*:: *<a-!>*::
append command output after selection. Shell expansions are available, append command output after each selection. Shell expansions are available,
(See <<expansions#shell-expansions,`:doc expansions shell-expansions`>>) (See <<expansions#shell-expansions,`:doc expansions shell-expansions`>>)
*u*:: *u*::
@ -331,8 +327,8 @@ the Shift modifier and moving will extend the selection instead.
move forward in history move forward in history
*&*:: *&*::
align selection, align the cursor of selections by inserting spaces align selections, align the cursor of each selection by inserting spaces
before the first character of the selection before the first character of each selection
*<a-&>*:: *<a-&>*::
copy indent, copy the indentation of the main selection (or the copy indent, copy the indentation of the main selection (or the
@ -348,11 +344,11 @@ the Shift modifier and moving will extend the selection instead.
swap case swap case
*@*:: *@*::
convert tabs to spaces in current selections, uses the buffer tabstop convert tabs to spaces in each selection, uses the buffer tabstop
option or the count parameter for tabstop option or the count parameter for tabstop
*<a-@>*:: *<a-@>*::
convert spaces to tabs in current selections, uses the buffer tabstop convert spaces to tabs in each selection, uses the buffer tabstop
option or the count parameter for tabstop option or the count parameter for tabstop
*_*:: *_*::
@ -374,7 +370,7 @@ the Shift modifier and moving will extend the selection instead.
== Goto commands == Goto commands
*g*, *G*:: *g*, *G*::
When a count is specified, *G* only extends the current selection to the given line, When a count is specified, *G* only extends the selection to the given line,
*g* sends the anchor to the given line and a menu is then displayed which waits *g* sends the anchor to the given line and a menu is then displayed which waits
for one of the following additional keys: for one of the following additional keys:
@ -451,24 +447,24 @@ Current selections position can be saved in a register and restored later on.
Marks use the *^* register by default (See <<registers#,`:doc registers`>>) Marks use the *^* register by default (See <<registers#,`:doc registers`>>)
*Z*:: *Z*::
save the current selections to the register save selections to the register
*z*:: *z*::
restore the selections from the register restore selections from the register
*<a-z>*, *<a-Z>*:: *<a-z>*, *<a-Z>*::
*<a-z>* combines the selections from the register with the current ones, whereas *<a-z>* combines selections from the register with the current ones, whereas
*<a-Z>* combines the current selections with the register; a menu is then *<a-Z>* combines current selections with the ones in the register; a menu
displayed which waits for one of the following additional keys: is then displayed which waits for one of the following additional keys:
*a*::: *a*:::
append the selections append selections
*u*::: *u*:::
keep a union of the selections keep a union of selections
*i*::: *i*:::
keep an intersection of the selections keep an intersection of selections
*<*::: *<*:::
select the selection with the leftmost cursor for each pair select the selection with the leftmost cursor for each pair
@ -500,11 +496,11 @@ Macros use the *@* register by default (See <<registers#,`:doc registers`>>)
Searches use the */* register by default (See <<registers#,`:doc registers`>>) Searches use the */* register by default (See <<registers#,`:doc registers`>>)
***:: ***::
set the search pattern to the current selection (automatically set the search pattern to the main selection (automatically
detects word boundaries) detects word boundaries)
*<a-***>*:: *<a-***>*::
set the search pattern to the current selection (verbatim, no smart set the search pattern to the main selection (verbatim, no smart
detection) detection)
== Jump list == Jump list
@ -520,36 +516,36 @@ to skim through the jump list using:
jump backward jump backward
*<c-s>*:: *<c-s>*::
save current selections save selections
== Multiple selections == Multiple selections
*s*:: *s*::
create a selection create a selection for each match of the given regex
*S*:: *S*::
split the current selection split selections with the given regex
*<a-s>*:: *<a-s>*::
split the current selections on line boundaries split selections on line boundaries
*<a-S>*:: *<a-S>*::
select first and last characters of each selections select first and last characters of each selection
*C*:: *C*::
copy the current selection to the next line copy the main selection to the next line
*<a-C>*:: *<a-C>*::
copy the current selection to the previous line copy the main selection to the previous line
*<space>*:: *<space>*::
clear a multiple selection clear selections to only keep the main one
*<a-space>*:: *<a-space>*::
clear the current selection clear the main selection
*<a-k>*:: *<a-k>*::
keep the selections that match the given regex keep selections that match the given regex
*<a-K>*:: *<a-K>*::
clear selections that match the given regex clear selections that match the given regex
@ -559,30 +555,36 @@ to skim through the jump list using:
for which the shell returned 0. Shell expansions are available, for which the shell returned 0. Shell expansions are available,
(See <<expansions#shell-expansions,`:doc expansions shell-expansions`>>) (See <<expansions#shell-expansions,`:doc expansions shell-expansions`>>)
*)*::
rotate main selection (the main selection becomes the next one)
*(*::
rotate main selection backward (the main selection becomes the previous one)
== Object Selection == Object Selection
For nestable objects, a count can be used in order to specify which surrounding For nestable objects, a count can be used in order to specify which surrounding
level to select. level to select.
*<a-a>*:: *<a-a>*::
selects the whole object select the whole object
*<a-i>*:: *<a-i>*::
selects the inner object, that is the object excluding its surrounder. select the inner object, that is the object excluding its surrounder.
For example, for a quoted string, this will not select the quote, and For example, for a quoted string, this will not select the quote, and
for a word this will not select trailing spaces. for a word this will not select trailing spaces.
*[*:: *[*::
selects to object start select to object start
*]*:: *]*::
selects to object end select to object end
*{*:: *{*::
extends selections to object start extend selections to object start
*}*:: *}*::
extends selections to object end extend selections to object end
After these keys, a second key needs to be entered in order to specify After these keys, a second key needs to be entered in order to specify
the wanted object: the wanted object: