man: make package nullable and default to null on darwin

2026-02-18 21:19:39 -06:00
parent f19a99503c
commit 2dedeb55b2
5 changed files with 61 additions and 3 deletions
@@ -36,3 +36,9 @@ changes are only active if the `home.stateVersion` option is set to
  you had the key `XDG_DESKTOP_DIR` before, you should now use the key
  `DESKTOP`. Home Manager 26.05 introduced a warning when the `XDG_<name>_DIR`
  form is used.
+
+- The [](#opt-programs.man.package) option now defaults to `null` on
+  Darwin because the GNU `man` from nixpkgs ships `apropos`/`man -k`
+  and `whatis`/`man -f` binaries that don't work on Darwin. Nix-installed
+  manual pages still work with macOS's built-in `man` via
+  [](#opt-home.extraOutputsToInstall).