summary refs log tree commit diff
path: root/nixos/doc/manual/development
diff options
context:
space:
mode:
authorVladimír Čunát <vcunat@gmail.com>2017-03-01 18:20:22 +0100
committerVladimír Čunát <vcunat@gmail.com>2017-03-01 21:56:01 +0100
commitfcec3e1c72ad7ac7eaacd00c8fc87dc04696fdb0 (patch)
treeb4a375a8a105886206cc6646128c283a6d8f6680 /nixos/doc/manual/development
parent4150920a51c911b45a39f512b4292c1de63990c3 (diff)
downloadnixlib-fcec3e1c72ad7ac7eaacd00c8fc87dc04696fdb0.tar
nixlib-fcec3e1c72ad7ac7eaacd00c8fc87dc04696fdb0.tar.gz
nixlib-fcec3e1c72ad7ac7eaacd00c8fc87dc04696fdb0.tar.bz2
nixlib-fcec3e1c72ad7ac7eaacd00c8fc87dc04696fdb0.tar.lz
nixlib-fcec3e1c72ad7ac7eaacd00c8fc87dc04696fdb0.tar.xz
nixlib-fcec3e1c72ad7ac7eaacd00c8fc87dc04696fdb0.tar.zst
nixlib-fcec3e1c72ad7ac7eaacd00c8fc87dc04696fdb0.zip
Revert "modules: add support for module replacement with disabledModules"
This reverts commit 3f2566689d14f1d7778d55ca807d1dad2f4695d1 for now.
Evaluation of the tested job got broken, blocking nixos-unstable.
Diffstat (limited to 'nixos/doc/manual/development')
-rw-r--r--nixos/doc/manual/development/replace-modules.xml75
-rw-r--r--nixos/doc/manual/development/writing-modules.xml1
2 files changed, 0 insertions, 76 deletions
diff --git a/nixos/doc/manual/development/replace-modules.xml b/nixos/doc/manual/development/replace-modules.xml
deleted file mode 100644
index cc0539ec5109..000000000000
--- a/nixos/doc/manual/development/replace-modules.xml
+++ /dev/null
@@ -1,75 +0,0 @@
-<section xmlns="http://docbook.org/ns/docbook"
-        xmlns:xlink="http://www.w3.org/1999/xlink"
-        xmlns:xi="http://www.w3.org/2001/XInclude"
-        version="5.0"
-        xml:id="sec-replace-modules">
-
-<title>Replace Modules</title>
-
-<para>Modules that are imported can also be disabled.  The option
-  declarations and config implementation of a disabled module will be
-  ignored, allowing another to take it's place.  This can be used to
-  import a set of modules from another channel while keeping the rest
-  of the system on a stable release.</para>
-<para><literal>disabledModules</literal> is a top level attribute like
-  <literal>imports</literal>, <literal>options</literal> and
-  <literal>config</literal>.  It contains a list of modules that will
-  be disabled. This can either be the full path to the module or a
-  string with the filename relative to the modules path
-  (eg. &lt;nixpkgs/nixos/modules&gt; for nixos).
-  </para>
-
-<para>This example will replace the existing postgresql module with
-  the version defined in the nixos-unstable channel while keeping the
-  rest of the modules and packages from the original nixos channel.
-  This only overrides the module definition, this won't use postgresql
-  from nixos-unstable unless explicitly configured to do so.</para>
-
-<programlisting>
-{ config, lib, pkgs, ... }:
-
-{
-  disabledModules = [ "services/databases/postgresql.nix" ];
-
-  imports =
-    [ # Use postgresql service from nixos-unstable channel.
-      # sudo nix-channel --add http://nixos.org/channels/nixos-unstable nixos-unstable
-      &lt;nixos-unstable/nixos/modules/services/databases/postgresql.nix&gt;
-    ];
-
-  services.postgresql.enable = true;
-}
-</programlisting>
-
-<para>This example shows how to define a custom module as a
-  replacement for an existing module. Importing this module will
-  disable the original module without having to know it's
-  implementation details.</para>
-
-<programlisting>
-{ config, lib, pkgs, ... }:
-
-with lib;
-
-let
-  cfg = config.programs.man;
-in
-
-{
-  disabledModules = [ "services/programs/man.nix" ];
-
-  options = {
-    programs.man.enable = mkOption {
-      type = types.bool;
-      default = true;
-      description = "Whether to enable manual pages.";
-    };
-  };
-
-  config = mkIf cfg.enabled {
-    warnings = [ "disabled manpages for production deployments." ];
-  };
-}
-</programlisting>
-
-</section>
diff --git a/nixos/doc/manual/development/writing-modules.xml b/nixos/doc/manual/development/writing-modules.xml
index 5bdcad5ceb57..ef6920160e6d 100644
--- a/nixos/doc/manual/development/writing-modules.xml
+++ b/nixos/doc/manual/development/writing-modules.xml
@@ -179,6 +179,5 @@ in {
 <xi:include href="option-types.xml" />
 <xi:include href="option-def.xml" />
 <xi:include href="meta-attributes.xml" />
-<xi:include href="replace-modules.xml" />
 
 </chapter>