docs: Cleanup for command examples

Author: tony

README.md

@@ -88,7 +88,8 @@ New session:
 'libtmux...:2.0'
 ```
 
-Time for some tech, direct to a rich, `Window` object:
+From raw command output, to a rich `Window` object (in practice and as shown
+later, you'd use `Session.new_window()`):
 
 ```python
 >>> Window.from_window_id(window_id=session.cmd('new-window', '-P', '-F#{window_id}').stdout[0], server=session.server)
@@ -102,7 +103,7 @@ Create a pane from a window:
 '%2'
 ```
 
-Magic, directly to a `Pane`:
+Raw output directly to a `Pane`:
 
 ```python
 >>> Pane.from_pane_id(pane_id=session.cmd('split-window', '-P', '-F#{pane_id}').stdout[0], server=session.server)

docs/quickstart.md

@@ -134,7 +134,8 @@ New session:
 'libtmux...:2.0'
 ```
 
-Time for some tech, direct to a rich, `Window` object:
+From raw command output, to a rich `Window` object (in practice and as shown
+later, you'd use {meth}`Session.new_window()`):
 
 ```python
 >>> Window.from_window_id(window_id=session.cmd('new-window', '-P', '-F#{window_id}').stdout[0], server=session.server)
@@ -148,7 +149,7 @@ Create a pane from a window:
 '%2'
 ```
 
-Magic, directly to a `Pane`:
+Raw output directly to a `Pane` (in practice, you'd use {meth}`Session.split_window()`):
 
 ```python
 >>> Pane.from_pane_id(pane_id=session.cmd('split-window', '-P', '-F#{pane_id}').stdout[0], server=session.server)

src/libtmux/server.py

@@ -189,7 +189,7 @@ def cmd(self, cmd: str, *args: t.Any) -> tmux_cmd:
         >>> session.cmd('new-window', '-P').stdout[0]
         'libtmux...:2.0'
 
-        Time for some tech, direct to a rich, `Window` object:
+        Output of `tmux -L ... new-window -P -F#{window_id}` to a `Window` object:
 
         >>> Window.from_window_id(window_id=session.cmd(
         ... 'new-window', '-P', '-F#{window_id}').stdout[0], server=session.server)
@@ -200,7 +200,7 @@ def cmd(self, cmd: str, *args: t.Any) -> tmux_cmd:
         >>> window.cmd('split-window', '-P', '-F#{pane_id}').stdout[0]
         '%5'
 
-        Magic, directly to a `Pane`:
+        Output of `tmux -L ... split-window -P -F#{pane_id}` to a `Pane` object:
 
         >>> Pane.from_pane_id(pane_id=session.cmd(
         ... 'split-window', '-P', '-F#{pane_id}').stdout[0], server=session.server)