stdenv: add stawman docs for `makeOverridable`

Also fix a typo in docs in haskell-modules.

Changed files
+19 -1
lib
pkgs
development
haskell-modules
+18
lib/customisation.nix
···
else { }));
+
/* `makeOverridable` takes a function from attribute set to attribute set and
+
injects `override` attibute which can be used to override arguments of
+
the function.
+
+
nix-repl> x = {a, b}: { result = a + b; }
+
+
nix-repl> y = lib.makeOverridable x { a = 1; b = 2; }
+
+
nix-repl> y
+
{ override = «lambda»; overrideDerivation = «lambda»; result = 3; }
+
+
nix-repl> y.override { a = 10; }
+
{ override = «lambda»; overrideDerivation = «lambda»; result = 12; }
+
+
Please refer to "Nixpkgs Contributors Guide" section
+
"<pkg>.overrideDerivation" to learn about `overrideDerivation` and caveats
+
related to its use.
+
*/
makeOverridable = f: origArgs:
let
ff = f origArgs;
+1 -1
pkgs/development/haskell-modules/make-package-set.nix
···
in generateExprs name src {}) overrides;
# : { root : Path
-
# , source-overrides : Defaulted (Either Path VersionNumber
+
# , source-overrides : Defaulted (Either Path VersionNumber)
# , overrides : Defaulted (HaskellPackageOverrideSet)
# } -> NixShellAwareDerivation
# Given a path to a haskell package directory whose cabal file is