]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
[3.11] Clarify one-item tuple (GH-114745) (#114758)
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Tue, 30 Jan 2024 18:50:32 +0000 (19:50 +0100)
committerGitHub <noreply@github.com>
Tue, 30 Jan 2024 18:50:32 +0000 (18:50 +0000)
A 'single tuple' means 'one tuple, of whatever length.
Remove the unneeded and slightly distracting parenthetical 'singleton' comment.
(cherry picked from commit a1332a99cf1eb9b879d4b1f28761b096b5749a0d)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
Doc/reference/expressions.rst

index 1fec404260d20e559635528e4ad25de164bb3587..2f346fbde39ecf5e82148ffa4aeaad27f842fadf 100644 (file)
@@ -1873,8 +1873,9 @@ the unpacking.
 
 .. index:: pair: trailing; comma
 
-The trailing comma is required only to create a single tuple (a.k.a. a
-*singleton*); it is optional in all other cases.  A single expression without a
+A trailing comma is required only to create a one-item tuple,
+such as ``1,``; it is optional in all other cases.
+A single expression without a
 trailing comma doesn't create a tuple, but rather yields the value of that
 expression. (To create an empty tuple, use an empty pair of parentheses:
 ``()``.)