From: Jacob Bower <1978924+jbower-fb@users.noreply.github.com>
Date: Tue, 9 May 2023 17:09:16 +0000 (-0700)
Subject: gh-97696 Add documentation for get_coro() behavior with eager tasks (#104304)
X-Git-Tag: v3.12.0b1~192
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2866e030f01dc3ff08de32857fa77d52468b676b;p=thirdparty%2FPython%2Fcpython.git

gh-97696 Add documentation for get_coro() behavior with eager tasks (#104304)
---

diff --git a/Doc/library/asyncio-task.rst b/Doc/library/asyncio-task.rst
index b2d7362a9de2..fe8d02815040 100644
--- a/Doc/library/asyncio-task.rst
+++ b/Doc/library/asyncio-task.rst
@@ -527,6 +527,8 @@ Running Tasks Concurrently
       and there is no running event loop.
 
 
+.. _eager-task-factory:
+
 Eager Task Factory
 ==================
 
@@ -1174,8 +1176,17 @@ Task Object
 
       Return the coroutine object wrapped by the :class:`Task`.
 
+      .. note::
+
+         This will return ``None`` for Tasks which have already
+         completed eagerly. See the :ref:`Eager Task Factory <eager-task-factory>`.
+
       .. versionadded:: 3.8
 
+      .. versionchanged:: 3.12
+
+         Newly added eager task execution means result may be ``None``.
+
    .. method:: get_context()
 
       Return the :class:`contextvars.Context` object