ilyakooo0/nixpkgs
1
0
Fork 0
mirror of https://github.com/ilyakooo0/nixpkgs.git synced 2024-12-27 05:43:50 +03:00
Code Issues Projects Releases Wiki Activity

Improve option types documentation.

Browse Source
This commit is contained in:
Marc Weber 2013-08-22 10:01:27 +03:00 committed by Evgeny Egorochkin
parent 983c87a1dd
commit a3f148ce96
1 changed files with 16 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
pkgs/lib/types.nix
View File

@ -19,7 +19,7 @@ rec {
# name (name of the type)
# check (boolean function)
# check (check the config value. Before returning false it should trace the bad value eg using traceValIfNot)
# merge (default merge function)
# iter (iterate on all elements contained in this type)
# fold (fold all elements contained in this type)
@ -196,8 +196,21 @@ rec {
hasOptions = false;
};
# !!! this should be a type constructor that takes the options as
# an argument.
# usually used with listOf, attrsOf, loaOf like this:
# users = mkOption {
# type = loaOf optionSet;
#
# # you can omit the list if there is one element only
# options = [ {
# name = mkOption {
# description = "name of the user"
# ...
# };
# # more options here
# } { more options } ];
# }
# TODO: !!! document passing options as an argument to optionSet,
# deprecate the current approach.
optionSet = mkOptionType {
name = "option set";
# merge is done in "options.nix > addOptionMakeUp > handleOptionSets"