Apropos: Difference between revisions
imported>Ncfavier document documentation.man.generateCaches |
m add category configuration |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
By default as of NixOS 21.05, <code>apropos</code>, <code>whatis</code> and <code>man -k</code> do not find anything when run | By default as of NixOS 21.05, <code>apropos</code>, <code>whatis</code> and <code>man -k</code> do not find anything when run, because the man page index cache is not generated. | ||
<syntaxhighlight lang= | To generate it manually (and again to update it when new software is installed), run: | ||
<syntaxhighlight lang="console"> | |||
$ sudo mkdir -p /var/cache/man/nixos | |||
$ sudo mandb | |||
</syntaxhighlight> | </syntaxhighlight> | ||
To enable automatically building the immutable cache, you can set in your system configuration: | |||
<syntaxhighlight lang="nix"> | |||
{ | |||
documentation.man.generateCaches = true; | |||
} | |||
</syntaxhighlight> | |||
Note that this will rebuild the cache every time you change anything in <code>environment.systemPackages</code>, and will make the <code>mandb</code> command fail. | |||
[[Category:Configuration]] | |||
Latest revision as of 17:51, 18 May 2025
By default as of NixOS 21.05, apropos, whatis and man -k do not find anything when run, because the man page index cache is not generated.
To generate it manually (and again to update it when new software is installed), run:
$ sudo mkdir -p /var/cache/man/nixos
$ sudo mandb
To enable automatically building the immutable cache, you can set in your system configuration:
{
documentation.man.generateCaches = true;
}
Note that this will rebuild the cache every time you change anything in environment.systemPackages, and will make the mandb command fail.