New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
nixos/documentation: add option to generate caches #86489
Conversation
Some notes:
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like this!
Bump, this looks nice and has been idle for 23 days. |
@eraserhd: It's essentially ready. I'm waiting for @lheckemann and @infinisil to complete their review. If you want to try it out, cherry-pick the commits on master because staging is likely broken. |
Sorry, didn't realise you were waiting for approval! mind wanders to NixOS/rfcs#30 |
When using --with-config-file, all man-db programs completely ignore the systemwide configuration in /etc/man_db.conf: it means on NixOS there is no way to change the configuration without rebuilding man-db, which in turn causes a mass-rebuild. To solve this problem this commit removes the NixOS-specific configuration in man-db, which wasn't the appropriate place to begin with: the package is expected to work on non-NixOS systems as well. Also a small patch now ensure /etc/man_db.conf is used, if available, before the bundled configuration.
Previously the NixOS-specific configuration for man-db was in the package itself and /etc/man.conf was completely ignored. This change moves it to /etc/man_db.conf, making declarative configuration practical again. It's now possible to generate the mandb caches for all packages installed through NixOS `environment.systemPackages` at build-time. The standard location for the stateful cache (/var/cache/man) is also configured to allow users to run `mandb` manually if they wish. Since generating the cache can be expensive the option is off by default.
Documented the change in the 20.09 release notes. |
Thank you @rnhmjoj for tackling this ❤️, the issue has bothered since always. |
Motivation for this change
An alternative approach to #76841 to generate manual pages caches. This will fix #14472.
Things done
apropos
,whatis
,mandb
works as intended)nix path-info -S
before and after)