docs(hooks): convert commented examples to runnable doctests

why: Commented code in docstrings violates project convention and provides
no documentation value since it won't run or be tested
what:
- get_hook_indices(): add full doctest with setup/teardown
- get_hook_values(): add doctest verifying SparseArray behavior
- set_hooks_bulk(): add doctests for dict, list, and clear_existing modes
- clear_hook(): add doctest demonstrating hook removal
- append_hook(): add doctest showing sequential index addition

All doctests verified to pass with pytest --doctest-modules

Author: tony

src/libtmux/hooks.py

@@ -410,9 +410,17 @@ def get_hook_indices(
 
         Examples
         --------
-        >>> # After setting hooks at indices 0, 1, 5:
-        >>> # session.get_hook_indices('session-renamed')
-        >>> # [0, 1, 5]
+        >>> session.set_hook('session-renamed[0]', 'display-message "test"')
+        Session($...)
+
+        >>> session.set_hook('session-renamed[5]', 'display-message "test"')
+        Session($...)
+
+        >>> session.get_hook_indices('session-renamed')
+        [0, 5]
+
+        >>> session.clear_hook('session-renamed')
+        Session($...)
         """
         hooks_output = self._show_hook(
             hook=hook,
@@ -455,9 +463,18 @@ def get_hook_values(
 
         Examples
         --------
-        >>> # values = session.get_hook_values('session-renamed')
-        >>> # for val in values.iter_values():
-        >>> #     print(val)
+        >>> session.set_hook('session-renamed[0]', 'display-message "first"')
+        Session($...)
+
+        >>> values = session.get_hook_values('session-renamed')
+        >>> 0 in values
+        True
+
+        >>> 'display-message' in values[0]
+        True
+
+        >>> session.clear_hook('session-renamed')
+        Session($...)
         """
         hooks_output = self._show_hook(
             hook=hook,
@@ -511,21 +528,40 @@ def set_hooks_bulk(
         --------
         Set hooks with explicit indices:
 
-        >>> # session.set_hooks_bulk('session-renamed', {
-        >>> #     0: 'display-message "hook 0"',
-        >>> #     1: 'display-message "hook 1"',
-        >>> # })
+        >>> session.set_hooks_bulk('session-renamed', {
+        ...     0: 'display-message "hook 0"',
+        ...     1: 'display-message "hook 1"',
+        ... })
+        Session($...)
+
+        >>> session.get_hook_indices('session-renamed')
+        [0, 1]
 
         Set hooks from a list (sequential indices):
 
-        >>> # session.set_hooks_bulk('after-new-window', [
-        >>> #     'select-pane -t 0',
-        >>> #     'send-keys "clear" Enter',
-        >>> # ])
+        >>> session.set_hooks_bulk('after-new-window', [
+        ...     'select-pane -t 0',
+        ...     'send-keys "clear" Enter',
+        ... ])
+        Session($...)
+
+        >>> session.get_hook_indices('after-new-window')
+        [0, 1]
+
+        Replace all existing hooks with ``clear_existing=True``:
 
-        Replace all existing hooks:
+        >>> session.set_hooks_bulk('session-renamed', {0: 'display-message "new"'},
+        ...                        clear_existing=True)
+        Session($...)
 
-        >>> # session.set_hooks_bulk('session-renamed', [...], clear_existing=True)
+        >>> session.get_hook_indices('session-renamed')
+        [0]
+
+        >>> session.clear_hook('session-renamed')
+        Session($...)
+
+        >>> session.clear_hook('after-new-window')
+        Session($...)
         """
         if clear_existing:
             self.clear_hook(hook, _global=_global, scope=scope)
@@ -571,7 +607,20 @@ def clear_hook(
 
         Examples
         --------
-        >>> # session.clear_hook('session-renamed')
+        >>> session.set_hook('session-renamed[0]', 'display-message "test"')
+        Session($...)
+
+        >>> session.set_hook('session-renamed[1]', 'display-message "test2"')
+        Session($...)
+
+        >>> session.get_hook_indices('session-renamed')
+        [0, 1]
+
+        >>> session.clear_hook('session-renamed')
+        Session($...)
+
+        >>> session.get_hook_indices('session-renamed')
+        []
         """
         indices = self.get_hook_indices(
             hook,
@@ -615,7 +664,17 @@ def append_hook(
 
         Examples
         --------
-        >>> # session.append_hook('session-renamed', 'display-message "appended"')
+        >>> session.set_hook('session-renamed[0]', 'display-message "first"')
+        Session($...)
+
+        >>> session.append_hook('session-renamed', 'display-message "appended"')
+        Session($...)
+
+        >>> session.get_hook_indices('session-renamed')
+        [0, 1]
+
+        >>> session.clear_hook('session-renamed')
+        Session($...)
         """
         indices = self.get_hook_indices(
             hook,