pyrox.dev
lol
lib/modules.nix: Deduplicate documentation
`file://./..` looks redundant, but makes the url clickable in vscode.
+2
-29
+2
-29
lib/modules.nix
+2
-29
lib/modules.nix
···
63
63
decls
64
64
));
65
65
66
-
/*
67
-
Evaluate a set of modules. The result is a set with the attributes:
68
-
69
-
‘options’: The nested set of all option declarations,
70
-
71
-
‘config’: The nested set of all option values.
72
-
73
-
‘type’: A module system type representing the module set as a submodule,
74
-
to be extended by configuration from the containing module set.
75
-
76
-
This is also available as the module argument ‘moduleType’.
77
-
78
-
‘extendModules’: A function similar to ‘evalModules’ but building on top
79
-
of the module set. Its arguments, ‘modules’ and ‘specialArgs’ are
80
-
added to the existing values.
81
-
82
-
Using ‘extendModules’ a few times has no performance impact as long
83
-
as you only reference the final ‘options’ and ‘config’.
84
-
If you do reference multiple ‘config’ (or ‘options’) from before and
85
-
after ‘extendModules’, performance is the same as with multiple
86
-
‘evalModules’ invocations, because the new modules' ability to
87
-
override existing configuration fundamentally requires a new
88
-
fixpoint to be constructed.
89
-
90
-
This is also available as a module argument.
91
-
92
-
‘_module’: A portion of the configuration tree which is elided from
93
-
‘config’. It contains some values that are mostly internal to the
94
-
module system implementation.
66
+
/* See https://nixos.org/manual/nixpkgs/unstable/#module-system-lib-evalModules
67
+
or file://./../doc/module-system/module-system.chapter.md
95
68
96
69
!!! Please think twice before adding to this argument list! The more
97
70
that is specified here instead of in the modules themselves the harder