From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 18 Apr 2025 17:47:25 +0000 (+0200)
Subject: [3.13] Minor doc edit: Make multinomial() the first math example (gh-132697) (gh... 
X-Git-Tag: v3.13.4~252
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=151828d52026a1d39e31e60cca53a76e876538f2;p=thirdparty%2FPython%2Fcpython.git

[3.13] Minor doc edit: Make multinomial() the first math example (gh-132697) (gh-132698)
---

diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index f996a365d56b..51bbca2cf0f2 100644
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -1009,6 +1009,12 @@ The following recipes have a more mathematical flavor:
 
 .. testcode::
 
+   def multinomial(*counts):
+       "Number of distinct arrangements of a multiset."
+       # Counter('abracadabra').values() → 5 2 2 1 1
+       # multinomial(5, 2, 2, 1, 1) → 83160
+       return prod(map(comb, accumulate(counts), counts))
+
    def powerset(iterable):
        "Subsequences of the iterable from shortest to longest."
        # powerset([1,2,3]) → () (1,) (2,) (3,) (1,2) (1,3) (2,3) (1,2,3)
@@ -1127,12 +1133,6 @@ The following recipes have a more mathematical flavor:
            n -= n // prime
        return n
 
-   def multinomial(*counts):
-       "Number of distinct arrangements of a multiset."
-       # Counter('abracadabra').values() → 5 2 2 1 1
-       # multinomial(5, 2, 2, 1, 1) → 83160
-       return prod(map(comb, accumulate(counts), counts))
-
 
 .. doctest::
     :hide: