Update docs, update error message, pin astroid version to a non-broken version

Author: oddbookworm

buildconfig/stubs/pygame/transform.pyi

@@ -463,7 +463,7 @@ def hsl(
 def pixelate(
     surface: Surface,
     pixel_size: int,
-    dest_surface: Optional[Surface] = None
+    dest_surface: Optional[Surface] = None,
 ) -> Surface:
     """Returns a pixelated version of the original surface.
 

pyproject.toml

@@ -60,6 +60,7 @@ requires = [
   "sphinx<=8.1.3",
   "sphinx-autoapi<=3.3.2",
   "pyproject-metadata!=0.9.1",
+  "astroid<=3.3.8",
 ]
 build-backend = 'mesonpy'
 

src_c/doc/transform_doc.h

@@ -21,3 +21,4 @@
 #define DOC_TRANSFORM_SOLIDOVERLAY "solid_overlay(surface, color, dest_surface=None, keep_alpha=False) -> Surface\nReplaces non transparent pixels with the provided color."
 #define DOC_TRANSFORM_THRESHOLD "threshold(dest_surface, surface, search_color, threshold=(0, 0, 0, 0), set_color=(0, 0, 0, 0), set_behavior=1, search_surf=None, inverse_set=False) -> int\nFinds which, and how many pixels in a surface are within a threshold of a 'search_color' or a 'search_surf'."
 #define DOC_TRANSFORM_HSL "hsl(surface, hue=0, saturation=0, lightness=0, dest_surface=None) -> Surface\nChange the hue, saturation, and lightness of a surface."
+#define DOC_TRANSFORM_PIXELATE "pixelate(surface, pixel_size, dest_surface=None) -> Surface\nReturns a pixelated version of the original surface."

src_c/transform.c

@@ -4248,13 +4248,13 @@ surf_pixelate(PyObject *self, PyObject *args, PyObject *kwargs)
 
     if (testWidth > INT_MAX || testWidth <= 0) {
         PyErr_SetString(PyExc_OverflowError,
-                        "Cannot scale width outside the range [0, INT_MAX]");
+                        "Cannot scale width outside the range (0, INT_MAX]");
         return NULL;
     }
 
     if (testHeight > INT_MAX || testHeight <= 0) {
         PyErr_SetString(PyExc_OverflowError,
-                        "Cannot scale height outside the range [0, INT_MAX]");
+                        "Cannot scale height outside the range (0, INT_MAX]");
         return NULL;
     }