public
/
nixpkgs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

* Fix typo and clarify why you should not use "mkFixStrictness" on top of 

plain list or attribute set.

svn path=/nixpkgs/trunk/; revision=18260
This commit is contained in:
Nicolas Pierron 2009-11-07 16:24:11 +00:00
parent b901c0e808
commit d791b830aa
1 changed files with 8 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
pkgs/lib/properties.nix
View File

@ -454,17 +454,19 @@ rec {
# properties on top of the option definition is nice for user manipulation # properties on top of the option definition is nice for user manipulation
# but require to check if the content of the property is not another # but require to check if the content of the property is not another
# property. Such testing implies to verify if this is an attribute set # property. Such testing implies to verify if this is an attribute set
# and if it possess the type "property". (see isProperty & typeOf) # and if it possess the type 'property'. (see isProperty & typeOf)
# #
# To avoid strict evaluation of option definitions, 'mkFixStrictness' is # To avoid strict evaluation of option definitions, 'mkFixStrictness' is
# introduced. This property protect the option definition by replacing # introduced. This property protects an option definition by replacing
# the base of the stack of properties by 'mkNotDef', when this property is # the base of the stack of properties by 'mkNotDef', when this property is
# evaluated it returns the original definition. # evaluated it returns the original definition.
# #
# This property is useful over any elements which may depends on an # This property is useful over any elements which depends on options which
# options which may raise an error if it gets evaluated whitout the proper # are raising errors when they get evaluated without the proper settings.
# settings. You do not need to use this on top of plain list or attribute #
# set. # Plain list and attribute set are lazy structures, which means that the
# container gets evaluated but not the content. Thus, using this property
# on top of plain list or attribute set is pointless.
# #
# This is a Hack, you should avoid it! # This is a Hack, you should avoid it!