More messing around with names.

This seems to be at it's heart an AutoAPI bug.  Not going to spend forever fighting it.

.github/workflows/build_docs.yaml

@@ -20,7 +20,7 @@ jobs:
     - name: Build HTML documentation with Sphinx
       run: |
         make html
-        make html SPHINXOPTS="--keep-going -n"
+        make html SPHINXOPTS="-W --keep-going"
       working-directory: docs
     - uses: actions/upload-pages-artifact@v3
       with:

.github/workflows/check_docs.yaml

@@ -18,7 +18,7 @@ jobs:
     - name: Build HTML documentation with Sphinx
       run: |
         make html
-        make html SPHINXOPTS="--keep-going -n"
+        make html SPHINXOPTS="-W --keep-going"
       working-directory: docs
     - uses: actions/upload-artifact@v4
       with:

docs/source/user_guide/index.rst

@@ -15,4 +15,3 @@ This is the user-guide for Tempe.
     introduction.rst
     installation.rst
     tutorial.rst
-    geometries.rst

src/tempe/markers.pyi

@@ -4,7 +4,7 @@ import framebuf
 from typing import Any
 
 from .geometry import Geometry
-from .shapes import ColoredGeometry, BLIT_KEY_RGB565, rectangle
+from .shapes import ColoredGeometry, BLIT_KEY_RGB565, rectangle, point_length
 from .surface import Surface
 
 
@@ -19,12 +19,27 @@ class Marker:
     CROSS = 6
 
 
-class Markers(ColoredGeometry):
-    """Display sized, colored markers at points."""
+class Markers(ColoredGeometry[point_length]):
+    """Display sized, colored markers at points.
+
+    Parameters
+    ----------
+    geometry : Iterable[geom] | None
+        The sequence of geometries to render.
+    colors : Iterable[int] | None
+        The sequence of colors for each geometry.
+    markers : Iterable[Any] | None
+        The sequence of colors for each geometry.
+    surface : Surface | None
+        The surface which this shape is associated with.
+    clip : rectangle | None
+        An (x, y, w, h) tuple to clip drawing to - anything drawn outside
+        this region will not show on the display.
+    """
 
     def __init__(
         self,
-        geometry: Geometry[tuple[int, int, int]],
+        geometry: Geometry[point_length],
         colors: Iterable[int],
         markers: Iterable[Any],
         *,
@@ -34,8 +49,19 @@ class Markers(ColoredGeometry):
 
     def update(
         self,
-        geometry: Geometry[tuple[int, int, int]] | None = None,
+        geometry: Iterable[point_length] | None = None,
         colors: Iterable[int] | None = None,
         markers: Iterable[Any] | None = None,
         **kwargs: Any,
-    ): ...
+    ):
+        """Update the state of the Shape, marking a redraw as needed.
+
+        Parameters
+        ----------
+        geometry : Iterable[geom] | None
+            The sequence of geometries to render.
+        colors : Iterable[int] | None
+            The sequence of colors for each geometry.
+        markers : Iterable[Any] | None
+            The sequence of colors for each geometry.
+        """

src/tempe/shapes.pyi

@@ -86,7 +86,11 @@ class Shape:
         this region will not show on the display.
     """
 
-    def __init__(self, surface: "tempe.surface.Surface | None" = None, clip: rectangle | None = None): ...
+    def __init__(
+        self,
+        surface: "tempe.surface.Surface | None" = None,
+        clip: rectangle | None = None,
+    ): ...
 
     def draw(self, buffer: FrameBuffer, x: int = 0, y: int = 0) -> None:
         """Render the shape into the given buffer offset by x and y.

src/tempe/surface.pyi

@@ -64,7 +64,7 @@ class Surface:
         ----------
         display : Display
             The actual physical display that the surface will be drawn on.
-        working_buffer : array[int]
+        working_buffer : array.array[int]
             An empty array of unsigned 16-bit ints (ie. ``array('H', ...)``)
             that the Surface will use as memory for temporary drawing buffers.
         """