fix: add links for make sphinx work

Author: alexfikl

doc/array.rst

@@ -308,3 +308,10 @@ Generating Arrays of Random Numbers
 -----------------------------------
 
 .. automodule:: pyopencl.clrandom
+
+Type Aliases
+------------
+
+.. class:: cl.Device
+
+    See :class:`pyopencl.Device`.

doc/conf.py

@@ -22,6 +22,7 @@
 nitpick_ignore = [
     ("py:class", r"numpy._typing._dtype_like._SupportsDType"),
     ("py:class", r"numpy._typing._dtype_like._DTypeDict"),
+    ("py:class", r"pytest.Metafunc"),
 ]
 
 intersphinx_mapping = {

pyopencl/tools.py

@@ -164,9 +164,9 @@
 if TYPE_CHECKING:
     from collections.abc import Callable, Hashable, Iterator, Mapping, Sequence
 
+    import pytest
     from mako.template import Template
     from numpy.typing import DTypeLike, NDArray
-    from pytest import Metafunc
 
 # Do not add a pyopencl import here: This will add an import cycle.
 
@@ -708,7 +708,7 @@ def get_test_platforms_and_devices(
 
 
 def get_pyopencl_fixture_arg_names(
-        metafunc: Metafunc,
+        metafunc: pytest.Metafunc,
         extra_arg_names: list[str] | None = None) -> list[str]:
     if extra_arg_names is None:
         extra_arg_names = []
@@ -760,7 +760,7 @@ def idfn(val: Any) -> str:
     return arg_values, idfn
 
 
-def pytest_generate_tests_for_pyopencl(metafunc: Metafunc) -> None:
+def pytest_generate_tests_for_pyopencl(metafunc: pytest.Metafunc) -> None:
     """Using the line::
 
         from pyopencl.tools import pytest_generate_tests_for_pyopencl