Apropos: Difference between revisions
imported>Ncfavier document documentation.man.generateCaches |
imported>Ncfavier Restore instructions for generating the cache manually |
||
| 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. | ||
To generate it manually (and again to update it when new software is installed), run: | |||
<syntaxhighlight lang=bash> | |||
sudo mkdir -p /var/cache/man/nixos | |||
sudo mandb | |||
</syntaxhighlight> | |||
To enable automatically building the immutable cache, you can set: | |||
<syntaxhighlight lang=nix> | <syntaxhighlight lang=nix> | ||
documentation.man.generateCaches = true; | documentation.man.generateCaches = true; | ||
</syntaxhighlight> | </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. | |||
Latest revision as of 09:51, 19 June 2021
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:
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.