update README

This commit is contained in:
Maxime Coste 2013-12-31 19:40:09 +00:00
parent d9b7eaef2b
commit 57329a6f41

View File

@ -12,10 +12,32 @@ keys are directly inserted into the current buffer. In normal mode, keys
are used to manipulate the current selection and to enter insertion mode. are used to manipulate the current selection and to enter insertion mode.
There is no concept of cursor in kakoune, only selections, a single character There is no concept of cursor in kakoune, only selections, a single character
selection can be seen as a cursor but there is no difference internally. selection can be seen as a cursor but there is no difference internally. A
selection is an oriented, inclusive range of characters.
see http://vimeo.com/82711574 see http://vimeo.com/82711574
Features
--------
* Multiple selection as a central way of interacting
* Powerful selection manipulation primitives
- Select all regex matches in current selections
- Keep selections containing/not containing a
match for a given regex
- Split current selections with a regex
- Text objects (paragraph, sentence, nestable blocks)
* Powerful text manipulation primitives
- Align selections
- Rotate selection contents
- Case manipulation
- Indentation
- Piping each selection to external filter
* Simple interaction with external programs
* Macros
* Hooks
* Syntax Highlighting
Building Building
-------- --------
@ -29,6 +51,9 @@ Kakoune dependencies are:
To build, just type *make* in the src directory To build, just type *make* in the src directory
Kakoune can be built on Linux, MacOS, and Cygwin. Due to Kakoune relying heavily
on being in an Unix like environment, no native Windows version is planned.
To setup a basic configuration on your account, type *make userconfig* in the To setup a basic configuration on your account, type *make userconfig* in the
src directory, this will setup an initial $XDG_CONFIG_HOME/kak directory. See src directory, this will setup an initial $XDG_CONFIG_HOME/kak directory. See
the _Kakrc_ section for more information. the _Kakrc_ section for more information.
@ -421,7 +446,7 @@ Options are typed, their type can be
* +regex+: as a string but the +set+ commands will complain * +regex+: as a string but the +set+ commands will complain
if the entered text is not a valid regex. if the entered text is not a valid regex.
* +{int,str}-list+: a list, elements are separated by a colon (:) * +{int,str}-list+: a list, elements are separated by a colon (:)
if an element needs to contain a colon, it can be escaped with a if an element needs to contain a colon, it can be escaped with a
backslash. backslash.
Options value can be changed using the +set+ commands: Options value can be changed using the +set+ commands:
@ -696,8 +721,8 @@ Some of kakoune state is available through environment variables:
* +kak_hook_param+: filtering text passed to the currently executing hook * +kak_hook_param+: filtering text passed to the currently executing hook
Note that in order to make only needed information available, Kakoune needs Note that in order to make only needed information available, Kakoune needs
to find the environement variable reference in the shell script executed. to find the environment variable reference in the shell script executed.
Hence +%sh{ ./script.sh }+ with +script.sh+ referencing an environement will Hence +%sh{ ./script.sh }+ with +script.sh+ referencing an environment will
not work. not work.
for example you can print informations on the current file in the status for example you can print informations on the current file in the status
@ -732,7 +757,7 @@ new commands can be defined using the +:def+ command.
def can also takes some flags: def can also takes some flags:
* +-env-params+: pass parameters given to commands in the environement as * +-env-params+: pass parameters given to commands in the environment as
kak_paramN with N the parameter number kak_paramN with N the parameter number
* +-shell-params+: pass parameters given to commands as positional parameters * +-shell-params+: pass parameters given to commands as positional parameters
to any shell expansions used in the command. to any shell expansions used in the command.
@ -826,7 +851,7 @@ Existing commands files are:
* *rc/git-tools.kak*: provides some git integration, like +:git-blame+, +:git-show+ * *rc/git-tools.kak*: provides some git integration, like +:git-blame+, +:git-show+
or +:git-diff-show+ or +:git-diff-show+
* *rc/make.kak*: provides the +:make+ and +:errjump+ commands along with * *rc/make.kak*: provides the +:make+ and +:errjump+ commands along with
highlighting for compiler output. highlighting for compiler output.
* *rc/man.kak*: provides the +:man+ command * *rc/man.kak*: provides the +:man+ command
* *rc/grep.kak*: provides the +:grep+ and +:gjump+ commands along with highlighting * *rc/grep.kak*: provides the +:grep+ and +:gjump+ commands along with highlighting
for grep output. for grep output.