remove incorrect comments, add link

Author: jakkdl

doc/en/deprecations.rst

@@ -71,7 +71,7 @@ should be changed to
 
 You can also make use of `pytest_fixture_setup` to handle the coroutine/asyncgen before pytest sees it - this is the way current async pytest plugins handle it.
 
-If a user has an async fixture with ``autouse=True`` in their ``conftest.py``, or in a file where they also have synchronous tests, they will also get this warning. We strongly recommend against this practice, and they should restructure their testing infrastructure so the fixture is synchronous or to separate the fixture from their synchronous tests. Note that the anyio pytest plugin has some support for sync test + async fixtures currently.
+If a user has an async fixture with ``autouse=True`` in their ``conftest.py``, or in a file where they also have synchronous tests, they will also get this warning. We strongly recommend against this practice, and they should restructure their testing infrastructure so the fixture is synchronous or to separate the fixture from their synchronous tests. Note that the `anyio pytest plugin <https://anyio.readthedocs.io/en/stable/testing.html>`_ has some support for sync test + async fixtures currently.
 
 
 .. _import-or-skip-import-error:

src/_pytest/compat.py

@@ -44,7 +44,6 @@ class NotSetType(enum.Enum):
 
 
 def is_generator(func: object) -> bool:
-    # note: this also returns true for async generator functions
     genfunc = inspect.isgeneratorfunction(func)
     return genfunc and not iscoroutinefunction(func)
 

src/_pytest/fixtures.py

@@ -885,8 +885,6 @@ def call_fixture_func(
     fixturefunc: _FixtureFunc[FixtureValue], request: FixtureRequest, kwargs
 ) -> FixtureValue:
     if is_generator(fixturefunc):
-        # note: this also triggers on async generators, suppressing 'unawaited coroutine'
-        # warning.
         fixturefunc = cast(
             Callable[..., Generator[FixtureValue, None, None]], fixturefunc
         )

testing/acceptance_test.py

@@ -1330,8 +1330,7 @@ async def async_fixture():
                 yield
 
             def test_foo(async_fixture):
-                # we don't need to suppress RuntimeWarning for unawaited coroutine
-                # as pytest internals accidentally do so already for async gens
+                # async gens don't emit unawaited-coroutine
                 ...
         """
     )