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.