Note recent additions to the changelog.

Author: HexDecimal

.vscode/settings.json

@@ -292,6 +292,7 @@
         "truetype",
         "undoc",
         "Unifont",
+        "unraisablehook",
         "upscaling",
         "VAFUNC",
         "vcoef",

CHANGELOG.md

@@ -4,6 +4,12 @@ Changes relevant to the users of python-tcod are documented here.
 This project adheres to [Semantic Versioning](https://semver.org/) since version `2.0.0`.
 
 ## [Unreleased]
+### Added
+- Adds `sdl_window` and `sdl_renderer` to tcod contexts.
+- Adds `tcod.event.add_watch` and `tcod.event.remove_watch` to handle SDL events via callback.
+- Adds the `tcod.sdl.video` module to handle SDL windows.
+- Adds the `tcod.sdl.render` module to handle SDL renderers.
+- Adds the `tcod.render` module which gives more control over the rendering of consoles and tilesets.
 ### Fixed
 - Fixed handling of non-Path PathLike parameters and filepath encodings.
 

tcod/context.py

@@ -355,7 +355,7 @@ def toggle_fullscreen(context: tcod.context.Context) -> None:
 
     @property
     def sdl_window(self) -> Optional[tcod.sdl.video.Window]:
-        """Return a tcod.sdl.video.Window referencing this contexts SDL window if it exists.
+        """Return a :any:`tcod.sdl.video.Window` referencing this contexts SDL window if it exists.
 
         .. versionadded:: 13.4
         """
@@ -364,7 +364,7 @@ def sdl_window(self) -> Optional[tcod.sdl.video.Window]:
 
     @property
     def sdl_renderer(self) -> Optional[tcod.sdl.render.Renderer]:
-        """Return a tcod.sdl.render.Renderer referencing this contexts SDL renderer if it exists.
+        """Return a :any:`tcod.sdl.render.Renderer` referencing this contexts SDL renderer if it exists.
 
         .. versionadded:: 13.4
         """

tcod/event.py

@@ -1089,6 +1089,10 @@ def add_watch(callback: _EventCallback) -> _EventCallback:
 
     Callbacks added as event watchers can later be removed with :any:`tcod.event.remove_watch`.
 
+    .. warning::
+        How uncaught exceptions in a callback are handled is not currently defined by tcod.
+        They will likely be handled by :any:`sys.unraisablehook`.
+
     Args:
         callback (Callable[[Event], None]):
             A function which accepts :any:`Event` parameters.
@@ -2303,6 +2307,8 @@ def __repr__(self) -> str:
     "get",
     "wait",
     "get_mouse_state",
+    "add_watch",
+    "remove_watch",
     "EventDispatch",
     "get_keyboard_state",
     "get_modifier_state",