nixpkgs/doc/builders/packages/kakoune.xml

<section xmlns="http://docbook.org/ns/docbook"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xml:id="sec-kakoune">
 <title>Kakoune</title>

 <para>
  Kakoune can be built to autoload plugins:
<programlisting>(kakoune.override {
  plugins = with pkgs.kakounePlugins; [ parinfer-rust ];
})</programlisting>
 </para>
</section>
doc: split packages part into xml file per package 2019-10-20 11:14:30 +00:00			`<section xmlns="http://docbook.org/ns/docbook"`
			`xmlns:xlink="http://www.w3.org/1999/xlink"`
			`xml:id="sec-kakoune">`
nixpkgs manual: fix white space and indentation 2019-10-30 10:03:55 +00:00			`<title>Kakoune</title>`
doc: split packages part into xml file per package 2019-10-20 11:14:30 +00:00
nixpkgs manual: fix white space and indentation 2019-10-30 10:03:55 +00:00			`<para>`
			`Kakoune can be built to autoload plugins:`
doc: split packages part into xml file per package 2019-10-20 11:14:30 +00:00			`<programlisting>(kakoune.override {`
kakoune: rework plugin support The previous implementation of plugin-support for the kakoune derivation was based on generating, at build time, a `plugins.kak` file that would source all .kak files in the list of plugins, and wrap the `kak` binary in a script that would add some command-line arguments so that this file gets loaded on start-up. The main problem with this approach is that the plugins' code get executed after the user's configuration file is loaded, so effectively one cannot automatically activate/configure these plugins. The idiomatic way of loading plugins is ensuring they end up installed somwhere under `share/kak/autoload`. Because plugins are already being packaged to have their code in `share/kak/autoload/plugins/<name-of-plugin>`, we can obtain a derivation that includes the plugins simply by doing a `symlinkJoin` of `kakoune-unwrapped` and all the requested plugins. For this to work, we need to fix two issues: 1. By default, kakoune makes `share/kak/autoload` a symbolic link to `share/kak/rc`, which contains all builtin definitions. We need to patch this to put the symlink under `share/kak/autoload/rc`, so that the join works. 2. By default kakoune expects the `autoload` directory to be in `../share/kak/autoload` relative to the location of the `kak` binary. We need to set the `KAKOUNE_RUNTIME` to point the symlinked share/kak for this to work. 2020-06-29 20:25:16 +00:00			`plugins = with pkgs.kakounePlugins; [ parinfer-rust ];`
doc: split packages part into xml file per package 2019-10-20 11:14:30 +00:00			`})</programlisting>`
nixpkgs manual: fix white space and indentation 2019-10-30 10:03:55 +00:00			`</para>`
			`</section>`