docs: tidy async docstrings and exports

Author: tony

src/libtmux/pane.py

@@ -24,6 +24,9 @@
 from libtmux.formats import FORMAT_SEPARATOR
 from libtmux.neo import Obj, fetch_obj
 
+__all__ = ["Pane", "PaneDirection"]
+
+
 if t.TYPE_CHECKING:
     import sys
     import types
@@ -412,9 +415,9 @@ async def acapture_pane(
 
         Notes
         -----
-        This method is non-blocking and suitable for use in async applications.
-        It's particularly powerful when capturing output from multiple panes concurrently
-        using ``asyncio.gather()``, which can significantly improve performance
+        This method is non-blocking and suitable for async applications. It is
+        especially helpful when capturing output from multiple panes concurrently
+        via ``asyncio.gather()``, which can significantly improve performance
         compared to sequential capture.
 
         .. versionadded:: 0.48.0

src/libtmux/server.py

@@ -394,8 +394,9 @@ async def acmd(
     async def ahas_session(self, target_session: str, exact: bool = True) -> bool:
         """Return True if session exists asynchronously.
 
-        This is the async version of :meth:`has_session`. It uses ``await self.acmd()``
-        for non-blocking session existence checks, making it suitable for async applications.
+        This is the async version of :meth:`has_session`. It uses
+        ``await self.acmd()`` for non-blocking session existence checks, making
+        it suitable for async applications.
 
         Equivalent to::
 

src/libtmux/session.py

@@ -295,8 +295,9 @@ async def acmd(
     async def arename_session(self, new_name: str) -> Session:
         """Rename session asynchronously and return session object.
 
-        This is the async version of :meth:`rename_session`. It uses ``await self.acmd()``
-        for non-blocking session renaming, making it suitable for async applications.
+        This is the async version of :meth:`rename_session`. It uses
+        ``await self.acmd()`` for non-blocking session renaming, making it
+        suitable for async applications.
 
         Equivalent to::
 
@@ -372,7 +373,9 @@ async def arename_session(self, new_name: str) -> Session:
         >>> async def test_chaining():
         ...     # arename_session returns self, allowing chaining
         ...     test_session = await server.anew_session("arename_chain_old")
-        ...     renamed_session = await test_session.arename_session("arename_chain_new")
+        ...     renamed_session = await test_session.arename_session(
+        ...         "arename_chain_new"
+        ...     )
         ...     window = await renamed_session.anew_window(window_name="main")
         ...     result = (renamed_session.session_name, window.window_name)
         ...     await server.acmd("kill-session", target="arename_chain_new")