[3.15] gh-152397: Provide a cross-reference to PEP 798 unpacking syntax (GH-152454...

Co-authored-by: Raymond Hettinger <rhettinger@users.noreply.github.com>
Co-authored-by: Rishit Agnihotri <Twix1288@users.noreply.github.com>

diff --git a/Doc/library/itertools.rst b/Doc/library/itertools.rst
index 06f8bf2a8b6fa81383fd0eeb0b52a0e14f3932bf..65442021ce1795d7f603a05374e9c98fa97d8ce0 100644 (file)
--- a/Doc/library/itertools.rst
+++ b/Doc/library/itertools.rst
@@ -197,6 +197,10 @@ loops that truncate the stream.
           for iterable in iterables:
               yield from iterable
 
+   Note that :pep:`798` unpacking syntax provides similar functionality
+   so that ``list(chain(p, q))`` could be written as
+   ``[*s for s in (p, q)]``.
+
 
 .. classmethod:: chain.from_iterable(iterable)
 
@@ -208,6 +212,10 @@ loops that truncate the stream.
           for iterable in iterables:
               yield from iterable
 
+   Note that :pep:`798` unpacking syntax provides similar functionality
+   so that ``list(chain.from_iterable(iterables))`` could be written as
+   ``[*s for s in iterables]``.
+
 
 .. function:: combinations(iterable, r)