Merge pull request cfengine#252 from tzz/feature/3804-clarify-randomi…

…nt-upper-bound

functions/randomint: clarify upper bound

reference/functions/randomint.markdown

@@ -9,11 +9,14 @@ tags: [reference, data functions, functions, randomint]
 
 [%CFEngine_function_prototype(lower, upper)%]
 
-**Description:** Returns a random integer between `lower` and `upper`.
+**Description:** Returns a random integer between `lower` and *up to but not including* `upper`.
 
 The limits must be integer values and the resulting numbers are based on
 the entropy of the md5 algorithm.
 
+The `upper` limit is excluded from the range.  Thus `randomint(0, 100)`
+will return 100 possible values, not 101.
+
 The function will be re-evaluated on each pass if it is not restricted with a
 context class expression as shown in the example.