asyncio.docs: Improve wordings; add a note to the Coroutines section. Issue #20706
diff --git a/Doc/library/asyncio-sync.rst b/Doc/library/asyncio-sync.rst
index 19e49ff..de38131 100644
--- a/Doc/library/asyncio-sync.rst
+++ b/Doc/library/asyncio-sync.rst
@@ -124,7 +124,7 @@
Otherwise, block until another coroutine calls :meth:`set` to set the
flag to true, then return ``True``.
- This method returns a :ref:`coroutine object <coroutine>`.
+ This method is a :ref:`coroutine <coroutine>`.
Condition
@@ -175,7 +175,7 @@
condition variable in another coroutine. Once awakened, it re-acquires
the lock and returns ``True``.
- This method returns a :ref:`coroutine object <coroutine>`.
+ This method is a :ref:`coroutine <coroutine>`.
.. method:: wait_for(predicate)
@@ -184,7 +184,7 @@
The predicate should be a callable which result will be interpreted as a
boolean value. The final predicate value is the return value.
- This method returns a :ref:`coroutine object <coroutine>`.
+ This method is a :ref:`coroutine <coroutine>`.
Semaphores
@@ -217,7 +217,7 @@
until some other coroutine has called :meth:`release` to make it larger
than ``0``, and then return ``True``.
- This method returns a :ref:`coroutine object <coroutine>`.
+ This method is a :ref:`coroutine <coroutine>`.
.. method:: locked()
@@ -279,7 +279,7 @@
If you yield from :meth:`get()`, wait until a item is available.
- This method returns a :ref:`coroutine object <coroutine>`.
+ This method is a :ref:`coroutine <coroutine>`.
.. method:: get_nowait()
@@ -295,7 +295,7 @@
If you yield from ``put()``, wait until a free slot is available before
adding item.
- This method returns a :ref:`coroutine object <coroutine>`.
+ This method is a :ref:`coroutine <coroutine>`.
.. method:: put_nowait(item)
@@ -350,7 +350,7 @@
it is complete. When the count of unfinished tasks drops to zero,
:meth:`join` unblocks.
- This method returns a :ref:`coroutine object <coroutine>`.
+ This method is a :ref:`coroutine <coroutine>`.
.. method:: task_done()