May 21, 2025 · May 15, 2025 · May 15, 2025 · May 15, 2025 · May 15, 2025 · May 15, 2025
diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst
   single: : (colon); compound statement

 The :keyword:`for` statement is used to iterate over the elements of a sequence
 (such as a string, tuple or list) or other iterable object:
 (such as a string, tuple, or list) or other iterable object:

 .. productionlist:: python-grammar
   for_stmt: "for" `target_list` "in" `starred_list` ":" `suite`
   for_stmt: "for" `target_list` "in" `expression_list` ":" `suite`
           : ["else" ":" `suite`]

 The ``starred_list`` expression is evaluated once; it should yield an
 :term:`iterable` object.  An :term:`iterator` is created for that iterable.
 The first item provided
 by the iterator is then assigned to the target list using the standard
 rules for assignments (see :ref:`assignment`), and the suite is executed.  This
 repeats for each item provided by the iterator.  When the iterator is exhausted,
 the suite in the :keyword:`!else` clause,
 The ``expression_list`` is evaluated once; it should yield an :term:`iterable` object.
 An :term:`iterator` is created for that iterable. The first item provided by the iterator
 is then assigned to the target list using the standard rules for assignments
 (see :ref:`assignment`), and the suite is executed. This repeats for each item provided
 by the iterator. When the iterator is exhausted, the suite in the :keyword:`!else` clause,
 if present, is executed, and the loop terminates.

 Note that as of Python 3.11, unpacking with starred expressions (e.g., ``*x``) is supported
 in the iterable expression list.

 .. index::
   pair: statement; break
   pair: statement; continue
Original file line number	Diff line number	Diff line change
Expand Up		@@ -151,21 +151,22 @@ The :keyword:`!for` statement
		single: : (colon); compound statement

		The :keyword:`for` statement is used to iterate over the elements of a sequence
		(such as a string, tuple or list) or other iterable object:
		(such as a string, tuple, or list) or other iterable object:
Copy link Member skirpichevMay 15, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Please see warnings on your pr. Copy link ContributorAuthor Yash-Vijay29May 15, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. okay yea saw it. found a "starred_expression_list" in thehttps://docs.python.org/3/reference/expressions.html#grammar-token-python-grammar-starred_expression_list. I will try to link it to that instead then Copy link ContributorAuthor Yash-Vijay29May 15, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. @skirpichev done, i reviewed it locally and doc seems proper. starred_list is turned into starred_expression_list mentioned already inhttps://docs.python.org/3/reference/expressions.html#grammar-token-python-grammar-starred_expression_list Copy link Member skirpichevMay 16, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Why this comma? Seems unrelated to the pr content. Copy link ContributorAuthor Yash-Vijay29May 16, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Why this comma? Seems unrelated to the pr content. While changing i just noticed a small grammar error and thought of fixing it. Its a small mistake but comma should be there after the tuple, I can make a separate PR for it if you want Copy link Member skirpichevMay 18, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. @StanFromIreland, does this looks correct for you? Copy link Contributor StanFromIrelandMay 18, 2025 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. It is anoxford comma, its usage is varied across contexts, but generally recommended in formal writing. It is unrelated to this pr and not very important, I am not against it staying, but I wouldn't be heavily opposed to removing it either.

		.. productionlist:: python-grammar
		for_stmt: "for" `target_list` "in" `starred_list` ":" `suite`
		for_stmt: "for" `target_list` "in" `expression_list` ":" `suite`
		: ["else" ":" `suite`]

		The ``starred_list`` expression is evaluated once; it should yield an
		:term:`iterable` object. An :term:`iterator` is created for that iterable.
		The first item provided
		by the iterator is then assigned to the target list using the standard
		rules for assignments (see :ref:`assignment`), and the suite is executed. This
		repeats for each item provided by the iterator. When the iterator is exhausted,
		the suite in the :keyword:`!else` clause,
		The ``expression_list`` is evaluated once; it should yield an :term:`iterable` object.
		An :term:`iterator` is created for that iterable. The first item provided by the iterator
		is then assigned to the target list using the standard rules for assignments
		(see :ref:`assignment`), and the suite is executed. This repeats for each item provided
		by the iterator. When the iterator is exhausted, the suite in the :keyword:`!else` clause,
		if present, is executed, and the loop terminates.

		Note that as of Python 3.11, unpacking with starred expressions (e.g., ``*x``) is supported
		in the iterable expression list.

		.. index::
		pair: statement; break
		pair: statement; continue
Expand Down