# [Python-checkins] Put math.comb() docs is correct place alphabetically (GH-13734)

Raymond Hettinger webhook-mailer at python.org
Sat Jun 1 18:01:50 EDT 2019

```https://github.com/python/cpython/commit/b7fade4f87e0d37d1686a4e8596141e55ecef099
branch: master
author: Raymond Hettinger <rhettinger at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2019-06-01T15:01:46-07:00
summary:

Put math.comb() docs is correct place alphabetically (GH-13734)

files:
M Doc/library/math.rst

diff --git a/Doc/library/math.rst b/Doc/library/math.rst
index 206b06edd2a2..8c6837050319 100644
--- a/Doc/library/math.rst
+++ b/Doc/library/math.rst
@@ -36,6 +36,21 @@ Number-theoretic and representation functions
:class:`~numbers.Integral` value.

+.. function:: comb(n, k)
+
+   Return the number of ways to choose *k* items from *n* items without repetition
+   and without order.
+
+   Also called the binomial coefficient. It is mathematically equal to the expression
+   ``n! / (k! (n - k)!)``. It is equivalent to the coefficient of the *k*-th term in the
+   polynomial expansion of the expression ``(1 + x) ** n``.
+
+   Raises :exc:`TypeError` if the arguments not integers.
+   Raises :exc:`ValueError` if the arguments are negative or if *k* > *n*.
+
+   .. versionadded:: 3.8
+
+
.. function:: copysign(x, y)

Return a float with the magnitude (absolute value) of *x* but the sign of
@@ -232,21 +247,6 @@ Number-theoretic and representation functions
:meth:`x.__trunc__() <object.__trunc__>`.

-.. function:: comb(n, k)
-
-   Return the number of ways to choose *k* items from *n* items without repetition
-   and without order.
-
-   Also called the binomial coefficient. It is mathematically equal to the expression
-   ``n! / (k! (n - k)!)``. It is equivalent to the coefficient of the *k*-th term in the
-   polynomial expansion of the expression ``(1 + x) ** n``.
-
-   Raises :exc:`TypeError` if the arguments not integers.
-   Raises :exc:`ValueError` if the arguments are negative or if *k* > *n*.
-
-   .. versionadded:: 3.8
-
-
Note that :func:`frexp` and :func:`modf` have a different call/return pattern
than their C equivalents: they take a single argument and return a pair of
values, rather than returning their second return value through an 'output

```