tests(doctests): For Pane.split

Author: tony

src/libtmux/pane.py

@@ -521,6 +521,62 @@ def split(
             Cell/row or percentage to occupy with respect to current window.
         environment: dict, optional
             Environmental variables for new pane. tmux 3.0+ only. Passthrough to ``-e``.
+
+        Examples
+        --------
+        >>> pane
+        Pane(%1 Window(@1 1:..., Session($1 ...)))
+
+        >>> new_pane = pane.split()
+
+        >>> new_pane
+        Pane(%2 Window(@1 1:..., Session($1 ...)))
+
+        >>> new_pane.pane_at_right
+        '1'
+
+        >>> new_pane.pane_at_left
+        '1'
+
+        >>> new_pane.pane_at_top
+        '0'
+
+        >>> new_pane.pane_at_bottom
+        '1'
+
+        >>> right_pane = pane.split(direction=PaneDirection.Right)
+
+        >>> right_pane
+        Pane(%3 Window(@1 1:..., Session($1 ...)))
+
+        >>> right_pane.pane_at_right
+        '1'
+
+        >>> right_pane.pane_at_left
+        '0'
+
+        >>> right_pane.pane_at_top
+        '1'
+
+        >>> right_pane.pane_at_bottom
+        '0'
+
+        >>> left_pane = pane.split(direction=PaneDirection.Left)
+
+        >>> left_pane
+        Pane(%4 Window(@1 1:..., Session($1 ...)))
+
+        >>> left_pane.pane_at_right
+        '0'
+
+        >>> left_pane.pane_at_left
+        '1'
+
+        >>> left_pane.pane_at_top
+        '1'
+
+        >>> left_pane.pane_at_bottom
+        '0'
         """
         tmux_formats = ["#{pane_id}" + FORMAT_SEPARATOR]