kakoune

Fork of kakoune, an acceptable text editor
git clone git://git.laack.co/kakoune.git
Log | Files | Refs

changelog.asciidoc (13255B)


      1 = Changelog
      2 
      3 To control the startup info message, see <<options#startup-info,`:doc options startup-info`>>
      4 
      5 This changelog contains major and/or breaking changes to Kakoune between
      6 released versions.
      7 
      8 == Development Version
      9 
     10 * A local scope is now active when evaluating a command line
     11 
     12 * The `-passes` switch of the `group` and `ref` highlighters now accepts
     13   `replace`, allowing `replace-ranges` highlighters to be put in groups
     14   and referenced from the shared scope
     15 
     16 == Kakoune 2026.05.21
     17 
     18 * Support the `\N` escape sequence in regex (like in PCRE, matches `[^\n]`).
     19 
     20 * `enter-user-mode` support the `-count` and `-register` switches to forward
     21   those parameters to the underlying normal mode
     22 
     23 * `arrange-buffers -back` switch to arrange provided buffers to the back of
     24   the buffer list.
     25 
     26 == Kakoune 2026.04.12
     27 
     28 * `finaleol` option to support writing files that do not end with an final
     29   end-of-line byte
     30 
     31 * `FocusIn`/`FocusOut` events on suspend
     32 
     33 * `%val{buffile}` is now empty for scratch buffers
     34 
     35 * Reworked Json UI draw_status call to give UI implementation more control,
     36   added cursor pos to the draw call and removed the set_cursor call
     37 
     38 * `number-lines -full-relative` switch to keep a smaller line number gutter.
     39 
     40 * `<a-I>` and `<a-A>` to select nested text objects
     41 
     42 * `kak -C <session>` connects to a session or creates it if it does not exist.
     43 
     44 == Kakoune 2025.06.03
     45 
     46 * Expose env vars that are mentioned in the arguments passed to shell expansions
     47 
     48 * Support for colored double underlines
     49 
     50 * `git apply` can now operate on selected changes in the current buffer's
     51   file (useful for quick (un)staging and reverting)
     52 
     53 * `exec/eval -client` switch accepts '*' for all clients and comma separated
     54   list of client names.
     55 
     56 == Kakoune 2024.05.18
     57 
     58 * Fixed tests on Alpine Linux and *BSD
     59 
     60 == Kakoune 2024.05.09
     61 
     62 * `flag-lines -after` switch to display text after the line
     63 
     64 * `shell-script-candidates` completion now runs the script asynchronously
     65   while displaying and updating results live.
     66 
     67 * `%val{window_range}` elements are now emitted as different strings
     68 
     69 * `+` only duplicates identical selections a single time to avoid surprising
     70   and slow exponential growth in the number of selections.
     71 
     72 * `daemonize-session` command makes it possible to convert the current session
     73   to a daemon one (which will not exit on last client disconnecting)
     74 
     75 * View mode commands and mouse scrolling no longer change selections when those go off-screen.
     76 
     77 * New commands `git apply`, `git blame-jump`, `git edit` and `git grep`.
     78 
     79 * `git blame` now also works in `git-diff` and `git-log` buffers.
     80 
     81 * Completions provided via `shell-script-candidates` or `completers` are no longer sorted if the typed text is empty.
     82 
     83 * The `terminal` alias has been replaced with a command that selects terminal program and placement based on windowing options.
     84 
     85 * `local` scopes in `commands` and `evaluate-commands`.
     86 
     87 == Kakoune 2023.08.08
     88 
     89 * Fix compilation errors on FreeBSD and MacOS using clang
     90 
     91 == Kakoune 2023.07.29
     92 
     93 * `<a-u>` and `<a-U>` now undo/redo selection changes; the previous meaning
     94   of moving in history tree has been moved to `<c-j>` and `<c-k>`
     95 
     96 * `%exp{...}` expansions provide flexible quoting for expanded strings
     97   (as double quoted strings)
     98 
     99 * `<c-g>` cancels the current operation and goes back to the main event
    100   loop, this provides an escape hatch when Kakoune seems to hang due to
    101   a costly operation
    102 
    103 * `show-matching -previous` highlighter will fall back onto the character
    104   preceeding the cursor
    105 
    106 == Kakoune 2022.10.31
    107 
    108 * `complete-command` (See <<commands#configuring-command-completion,`:doc commands configuring-command-completion`>>)
    109 
    110 * `p`, `P`, `!` and `<a-!>` commands now select the inserted text
    111 
    112 * `x` now just extends the selection to contain full lines (as `<a-x>` did)
    113   `<a-x>` trims partial lines from the selection (as `<a-X>` did)
    114 
    115 * User mappings is now bound to `<space>` while keeping/removing main selection
    116   moved to `,` and `<a-,>`
    117 
    118 * Prompt history registers `%reg{colon}`, `%reg{slash}` and `%reg{pipe}` now
    119   have reverse chronological order
    120 
    121 * Executing user mode mappings no longer adds to prompt history registers.
    122 
    123 == Kakoune 2021.11.07
    124 
    125 * Support for curly and separately colored underlines (undocumented in 2021.10.28)
    126 
    127 * Fixes for terminal flickering
    128 
    129 * Fixes for command and response fifo corner cases
    130 
    131 == Kakoune 2021.10.28
    132 
    133 * `g` and `v` do not auto lower case the next key, so `GL` needs to be
    134   manually mapped to `Gl` for example.
    135 
    136 == Kakoune 2021.08.28
    137 
    138 * command and response fifo support
    139   (See <<expansions#command-and-response-fifo,`:doc expansions command-and-response-fifo`>>)
    140 
    141 * Shell expansions only trim the last trailing newline instead of all of
    142   them to make is possible to losslessly pass text through `%sh{...}`. 
    143 
    144 * `set-option -remove` support for subtracting/removing from option values
    145 
    146 * Menu completions such as command name completion are now auto-inserted on
    147   space
    148 
    149 * `write -atomic` was replaced with `write -method [replace|overwrite]` to
    150   make both write methods available explicitly
    151 
    152 * `write <filename>` will fail if the given filename already exists and is
    153   a regular file. Use the `-force` switch to override that behaviour.
    154 
    155 == Kakoune 2020.09.01
    156 
    157 * The `repl` and `send-text` aliases have been renamed respectively into
    158   `repl-new` and `repl-send-text`.
    159 
    160 * Daemon mode (`-d` switch) does not fork anymore.
    161 
    162 * Replace NCursesUI with a custom terminal UI implementation
    163 
    164 == Kakoune 2020.08.04
    165 
    166 * Introduce `User` hook support.
    167 
    168 * The `bold` and `italic` faces are no longer built-in. Highlighters
    169   are expected to use face attributes (`+b` and `+i`, respectively) to
    170   decorate text.
    171 
    172 * The `lint-enable` command no longer needs to be called to display
    173   linting errors. The `lint-disable` command was renamed into
    174   `lint-hide-diagnostics`.
    175 
    176 * The `+<length>` part of a `range-specs` highlighter consistently
    177   refers to the length of the target range.
    178 
    179 * clients stdin is transferred to the server, making it possible
    180   to pipe into `kak -c <session>`
    181 
    182 * Faces can have an alpha channel, specified using the 
    183   `rgba:RRGGBBAA` format.
    184 
    185 * replace-ranges highlighter now support empty and multi-lines ranges
    186 
    187 * `%val{...}` now expands to list of strings, `$kak_quoted_...` now work
    188   as expected with these.
    189 
    190 * `*SetOption` hooks filter string will contain a value only for options
    191   of int/str/bool types to avoid performance issue with generating those
    192   on more complex option types. 
    193 
    194 == Kakoune 2020.01.16
    195 
    196 * Expose history tree through `$kak_history` and
    197   `$kak_uncommitted_modifications`
    198 
    199 * `InsertCompletionHide` parameter is the list of inserted
    200   ranges
    201 
    202 == Kakoune 2019.12.10
    203 
    204 * Arrow keys and `<home>`, `<end>` are not normal mode commands
    205   anymore but default key mappings.
    206   
    207 * `ModeChange` hook parameter now takes `push:` or `pop:` prefix,
    208   `InsertBegin`, `InsertEnd`, `NormalBegin` and `NormalEnd`
    209   were removed.
    210 
    211 * `-verbatim` switch in `evaluate-commands` for perfect command
    212   forwarding to another context.
    213 
    214 * `WrapMarker` face used by `wrap -marker` highlighter
    215 
    216 * `info` supports markup with the `-markup` switch
    217 
    218 * `rename-buffer` gained `-file` and `-scratch` switches
    219   to support converting buffer types.  
    220 
    221 == Kakoune 2019.07.01
    222 
    223 * Re-organized bundled script files directory hierarchy.
    224 
    225 * Introduced helpers to write/read from file in scripts with
    226   `%file{...}` expansion and `echo -to-file <filename>`.
    227 
    228 * Added `ClientCreate` and `ClientClose` hooks
    229 
    230 * `edit -scratch` with no buffer name will create a new
    231   scratch buffer with a unique autogenerated name.
    232 
    233 * `info -placement` is now `info -style` and supports
    234   `menu` and `modal` additional styles.
    235 
    236 * `completions` option type `docstring` are now arbitrary
    237   kakoune commands that are run on item select.
    238 
    239 * `InsertCompletionSelect` hook has been removed as
    240   `completions` commands now provides a similar feature.
    241 
    242 * Introduced a module system using the `provide-module` and
    243   `require-module` commands that allows for lazily loading language
    244   support files with dependency resolution.
    245 
    246 * Added a new hook `ModuleLoaded` which is run after a module is
    247   loaded, allowing for module specific configuration.
    248 
    249 * Shell quoting of lists is not automatic anymore, `$kak_quoted_...`
    250   makes it opt-in, and works for all option types.
    251 
    252 * Lower case function key syntax is not accepted anymore,
    253   `<f1>` should be converted to `<F1>`.
    254 
    255 == Kakoune 2019.01.20
    256 
    257 * `auto_complete` has been renamed to `autocomplete` for more
    258   consistency.
    259 
    260 * Start of a builtin key parser in the ncurses ui bypassing
    261   the ncurses one. Can be favored by setting the ui option
    262   `ncurses_builtin_key_parser` to `true`.
    263 
    264 * Right clicks extend the current selection, the control modifier allows
    265   merging all the selections after extension.
    266 
    267 * The `regex` highlighter now supports named capture groups to
    268   ease readability.
    269 
    270 == Kakoune 2018.10.27
    271 
    272 * `remove-hooks` <group> argument is now a regex and removes all
    273   hooks whose group matches it.
    274 
    275 * `exclusive` face attribute (e) has been replaced with more
    276   granular `final foreground` (f), `final background` (g), and `final
    277   attributes` (a), or the three combined as `final` (F).  Semantics
    278   changed slightly as those attributes apply to the existing face as
    279   well (a final face will not get modified by a following face if that
    280   following face does not have the final attribute itself.
    281 
    282 * `<a-m>` aka "merge consecutive selections" has been moved to `<a-_>`.
    283   The new `<a-m>` and `<a-M>` are now symmetrical with `m` and `M`.
    284   Those commands select (or extend) to the matching char backwards.
    285 
    286 * `define-command` switches `-shell-completion` and `-shell-candidates`
    287   have been renamed to `-shell-script-completion` and
    288   `-shell-script-candidates` to make way for a new `-shell-completion`
    289   which completes like the shell (shell command name then filename).
    290 
    291 * `asciidoc` is not a dependency anymore, the last file that required
    292   it (Kakoune's manpage) has been converted to troff format.
    293 
    294 == Kakoune 2018.09.04
    295 
    296 This version contains a significant overhaul of various Kakoune
    297 features that can break user configuration. This was a necessary
    298 change to make Kakoune command model cleaner and more robust.
    299 
    300 * `%sh{...}` strings are not reparsed automatically anymore, they need
    301   to go through an explicit `evaluate-commands`
    302 
    303 * The `-allow-override` switch from `define-command` has been renamed
    304   `-override`.
    305 
    306 * The search prompt uses buffer word completion so that fuzzy completion
    307   can be used to quickly search for a buffer word.
    308 
    309 * The `wrap` highlighter can accept a new `-marker <marker_text>` switch.
    310 
    311 * The command line syntax has changed to support robust escaping.
    312 
    313   - `%sh{...}` is not expanded to multiple tokens automatically anymore,
    314     to evaluate its output as multiple tokens/commands, use the
    315     `evaluate-commands` command:
    316 
    317    -------------------------------------------------------------
    318    evaluate-commands %sh{ echo "first command; second command" }
    319    -------------------------------------------------------------
    320 
    321   - Escaping of `'` in `'...'` and `"` and `%` in `"..."` strings is done
    322     by doubling up (`''`, `""` and `%%`) instead of using a backslash
    323 
    324   - Bare words escaping has been tweaked.
    325 
    326   See <<command-parsing#,`:doc command-parsing`>>.
    327 
    328 * Various lists (options, registers...) in Kakoune are now written using
    329   the command line syntax:
    330 
    331   - `set-register` now take an arbitrary number of parameters and sets
    332     the register to multiple strings. `%reg` expands to a list of strings.
    333 
    334   - the `$kak_reg_*` environment variable is now a list, `$kak_main_reg_*`
    335     provides the previous behaviour.
    336 
    337   - `%opt` expands list options as list of strings.
    338 
    339   - selection descs are whitespaces separated instead of `:` separated
    340 
    341 * Highlighters syntax has changed to permit explicit naming and remove
    342   highlighter specific name parameters (such as for the group highlighter)
    343   `add-highlighter <path>/<name> <type> <params>` is the new syntax.
    344 
    345 * Regions highlighters have been overhauled and are now specified with
    346   a sequence of commands instead of a single one:
    347 
    348   ------------------------------------------------------------------
    349   add-highlighter <path>/<name> regions
    350   add-highlighter <path>/<name>/<region name> region <begin> <end> \
    351   <type> <params>
    352   ------------------------------------------------------------------
    353 
    354   The recursion regex is opt-in through a `-recurse <recurse>` flag.
    355 
    356   They also are not necessarily groups anymore, a region can directly
    357   apply any other highlighter
    358 
    359   See <<highlighters#,`:doc highlighters`>>
    360 
    361 * Highlighter type names have been unified, types that used `_` as
    362   word separators, such as `show_whitespaces` are now using `-`
    363   (`show-whitespace`).
    364 
    365 * `a` on end of line is not treated specially anymore, it will start
    366   inserting on the next character, which will be the first character
    367   of the next line.
    368 
    369 * `autoshowcompl` options has been renamed `auto_complete` and is
    370   now a `flags(insert|prompt)` option, allowing more granular
    371   configuration of when the completions should be displayed
    372   automatically.
    373 
    374 * Prompt editing shortcuts have been changed to match readline.
    375 
    376 == Kakoune 2018.04.13
    377 
    378 First official Kakoune release.