summary refs log tree commit diff
path: root/lib/modules.nix
diff options
context:
space:
mode:
authorRobert Hensing <robert@roberthensing.nl>2023-04-16 19:03:05 +0200
committerRobert Hensing <robert@roberthensing.nl>2023-05-06 18:32:58 +0200
commit73f584c3cc20015bfd1c4c72ebc6240897c10e48 (patch)
treed896229965d55c2a600169f9955ce648042fd82a /lib/modules.nix
parent03a465f0489ce35c86606dd5ef7dffa877c91dde (diff)
downloadnixpkgs-73f584c3cc20015bfd1c4c72ebc6240897c10e48.tar
nixpkgs-73f584c3cc20015bfd1c4c72ebc6240897c10e48.tar.gz
nixpkgs-73f584c3cc20015bfd1c4c72ebc6240897c10e48.tar.bz2
nixpkgs-73f584c3cc20015bfd1c4c72ebc6240897c10e48.tar.lz
nixpkgs-73f584c3cc20015bfd1c4c72ebc6240897c10e48.tar.xz
nixpkgs-73f584c3cc20015bfd1c4c72ebc6240897c10e48.tar.zst
nixpkgs-73f584c3cc20015bfd1c4c72ebc6240897c10e48.zip
lib/modules.nix: Deduplicate documentation
`file://./..` looks redundant, but makes the url clickable in vscode.
Diffstat (limited to 'lib/modules.nix')
-rw-r--r--lib/modules.nix31
1 files changed, 2 insertions, 29 deletions
diff --git a/lib/modules.nix b/lib/modules.nix
index 4533252c60e..e83d5b6d1ca 100644
--- a/lib/modules.nix
+++ b/lib/modules.nix
@@ -63,35 +63,8 @@ let
           decls
       ));
 
-  /*
-    Evaluate a set of modules.  The result is a set with the attributes:
-
-      ‘options’: The nested set of all option declarations,
-
-      ‘config’: The nested set of all option values.
-
-      ‘type’: A module system type representing the module set as a submodule,
-            to be extended by configuration from the containing module set.
-
-            This is also available as the module argument ‘moduleType’.
-
-      ‘extendModules’: A function similar to ‘evalModules’ but building on top
-            of the module set. Its arguments, ‘modules’ and ‘specialArgs’ are
-            added to the existing values.
-
-            Using ‘extendModules’ a few times has no performance impact as long
-            as you only reference the final ‘options’ and ‘config’.
-            If you do reference multiple ‘config’ (or ‘options’) from before and
-            after ‘extendModules’, performance is the same as with multiple
-            ‘evalModules’ invocations, because the new modules' ability to
-            override existing configuration fundamentally requires a new
-            fixpoint to be constructed.
-
-            This is also available as a module argument.
-
-      ‘_module’: A portion of the configuration tree which is elided from
-            ‘config’. It contains some values that are mostly internal to the
-            module system implementation.
+  /* See https://nixos.org/manual/nixpkgs/unstable/#module-system-lib-evalModules
+     or file://./../doc/module-system/module-system.chapter.md
 
      !!! Please think twice before adding to this argument list! The more
      that is specified here instead of in the modules themselves the harder