https://github.com/python/cpython/commit/f1f0f2e3d740c96edd233f4f1a1aa76cdc81bb53 commit: f1f0f2e3d740c96edd233f4f1a1aa76cdc81bb53 branch: 3.11 author: Miss Islington (bot) <[email protected]> committer: terryjreedy <[email protected]> date: 2024-01-30T18:50:32Z summary:
[3.11] Clarify one-item tuple (GH-114745) (#114758) 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 <[email protected]> files: M Doc/reference/expressions.rst diff --git a/Doc/reference/expressions.rst b/Doc/reference/expressions.rst index 1fec404260d20e..2f346fbde39ecf 100644 --- a/Doc/reference/expressions.rst +++ b/Doc/reference/expressions.rst @@ -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: ``()``.) _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3/lists/python-checkins.python.org/ Member address: [email protected]
