From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Fri, 19 Jul 2019 09:17:21 +0000 (-0700) Subject: bpo-37624: Document weight assumptions for random.choices() (GH-14855) (GH-14858) X-Git-Tag: v3.8.0b3~40 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a50a6225a06e5a83ce2a880a7eb4496043fdbb55;p=python bpo-37624: Document weight assumptions for random.choices() (GH-14855) (GH-14858) (cherry picked from commit 8dbe563aa6bd18b8c581951537dfb406d36e8063) Co-authored-by: Raymond Hettinger --- diff --git a/Doc/library/random.rst b/Doc/library/random.rst index fcedba4dbc..90b86248e6 100644 --- a/Doc/library/random.rst +++ b/Doc/library/random.rst @@ -160,7 +160,8 @@ Functions for sequences The *weights* or *cum_weights* can use any numeric type that interoperates with the :class:`float` values returned by :func:`random` (that includes - integers, floats, and fractions but excludes decimals). + integers, floats, and fractions but excludes decimals). Weights are + assumed to be non-negative. For a given seed, the :func:`choices` function with equal weighting typically produces a different sequence than repeated calls to