From: AN Long <aisk@users.noreply.github.com>
Date: Fri, 9 Jan 2026 12:18:32 +0000 (+0900)
Subject: gh-72239: Add note distinguishing concurrent.futures.Future from asyncio.Future ... 
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a9ca49d9c699ce4040f1391d9054d88b4098466b;p=thirdparty%2FPython%2Fcpython.git

gh-72239: Add note distinguishing concurrent.futures.Future from asyncio.Future (#143288)
---

diff --git a/Doc/library/concurrent.futures.rst b/Doc/library/concurrent.futures.rst
index 8b6d749f40cb..e4b505c3f976 100644
--- a/Doc/library/concurrent.futures.rst
+++ b/Doc/library/concurrent.futures.rst
@@ -21,6 +21,11 @@ or separate processes, using :class:`ProcessPoolExecutor`.
 Each implements the same interface, which is defined
 by the abstract :class:`Executor` class.
 
+:class:`concurrent.futures.Future` must not be confused with
+:class:`asyncio.Future`, which is designed for use with :mod:`asyncio`
+tasks and coroutines. See the :doc:`asyncio's Future <asyncio-future>`
+documentation for a detailed comparison of the two.
+
 .. include:: ../includes/wasm-notavail.rst
 
 Executor Objects