Fix API reference.

Author: Aermoss

docs/conf.py

@@ -4,6 +4,7 @@
 sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
 
 os.environ["SDL_DOC_GENERATOR"] = "0"
+os.environ["SDL_CTYPES_ALIAS_FIX"] = "1"
 os.environ["SDL_DISABLE_METADATA"] = "1"
 os.environ["SDL_PLATFORM_AGNOSTIC"] = "1"
 os.environ["SDL_IGNORE_MISSING_FUNCTIONS"] = "1"
@@ -25,11 +26,11 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.autosummary",
-    "sphinx.ext.napoleon",
+    "sphinx.ext.inheritance_diagram",
     "sphinx.ext.intersphinx",
     "sphinx.ext.viewcode",
-    "sphinx.ext.todo",
-    "sphinx.ext.inheritance_diagram"
+    "sphinx.ext.napoleon",
+    "sphinx.ext.todo"
 ]
 
 templates_path = []

sdl3/__init__.py

@@ -400,7 +400,7 @@ def SDL_GENERATE_DOCS(modules: list[str] = list(SDL_BINARY_VAR_MAP_INV.keys()),
     result = "" if rst else f"\"\"\"\n# This file is auto-generated, do not modify it.\nmeta = "
     if not rst: result += f"{{\"target\": \"v{__version__}\", \"system\": \"{SDL_SYSTEM}\"}}\n\"\"\"\n\n"
     result += f"from {'sdl3' if rst else ''}.SDL import *\n\n"
-    result += f"from {'sdl3' if rst else ''}.__init__ import raw, ctypes, typing, SDL_POINTER\n\n"
+    result += f"from {'sdl3' if rst else ''}.__init__ import {'' if rst else 'raw, '}ctypes, typing, SDL_POINTER\n\n"
     types, definitions = set(), ""
 
     def SDL_GET_NAME(i):
@@ -424,7 +424,8 @@ def SDL_GET_NAME(i):
             if description is not None: definitions += f"    {description}\n"
             if not rst: definitions += f"\n{' ' * 4}https://wiki.libsdl.org/{module}/{func}\n"
             if not rst or description is not None: definitions += f"{' ' * 4}\"\"\"\n"
-            definitions += f"{' ' * 4}return raw.{func}({', '.join(arguments)})"
+            if not rst: definitions += f"{' ' * 4}return raw.{func}({', '.join(arguments)})"
+            else: definitions += f"{' ' * 4}..."
 
             if _index != len(__module__.functions[module]) - 1:
                 definitions += "\n\n"