64 lines
1.9 KiB
Nix
64 lines
1.9 KiB
Nix
{ config, lib, pkgs, baseModules, ... }:
|
|
|
|
with lib;
|
|
|
|
let
|
|
|
|
/* For the purpose of generating docs, evaluate options with each derivation
|
|
in `pkgs` (recursively) replaced by a fake with path "\${pkgs.attribute.path}".
|
|
It isn't perfect, but it seems to cover a vast majority of use cases.
|
|
Caveat: even if the package is reached by a different means,
|
|
the path above will be shown and not e.g. `${config.services.foo.package}`. */
|
|
homeManagerManual = import ../doc {
|
|
inherit pkgs config;
|
|
version = "0.1";
|
|
revision = "master";
|
|
options =
|
|
let
|
|
scrubbedEval = evalModules {
|
|
modules = [ { nixpkgs.localSystem = config.nixpkgs.localSystem; } ] ++ baseModules;
|
|
args = (config._module.args) // { modules = [ ]; };
|
|
specialArgs = { pkgs = scrubDerivations "pkgs" pkgs; };
|
|
};
|
|
scrubDerivations = namePrefix: pkgSet: mapAttrs
|
|
(name: value:
|
|
let wholeName = "${namePrefix}.${name}"; in
|
|
if isAttrs value then
|
|
scrubDerivations wholeName value
|
|
// (optionalAttrs (isDerivation value) { outPath = "\${${wholeName}}"; })
|
|
else value
|
|
)
|
|
pkgSet;
|
|
in scrubbedEval.options;
|
|
};
|
|
|
|
in
|
|
|
|
{
|
|
options = {
|
|
manual.manpages.enable = mkOption {
|
|
type = types.bool;
|
|
default = true;
|
|
example = false;
|
|
description = ''
|
|
Whether to install the configuration manual page. The manual can
|
|
be reached by <command>man home-configuration.nix</command>.
|
|
</para><para>
|
|
When looking at the manual page pretend that all references to
|
|
NixOS stuff are actually references to Home Manager stuff.
|
|
Thanks!
|
|
'';
|
|
};
|
|
};
|
|
|
|
config = mkIf config.manual.manpages.enable {
|
|
home.packages = [ homeManagerManual.manpages ];
|
|
};
|
|
|
|
# To fix error during manpage build.
|
|
meta = {
|
|
maintainers = [ maintainers.rycee ];
|
|
doc = builtins.toFile "nothingness" "";
|
|
};
|
|
}
|