Initial docs for panes, servers, sessions, windows

Author: tony

doc/panes.rst

@@ -4,4 +4,9 @@
 Panes
 =====
 
-In tmux,
+- hold `pseudoterminal`_'s (`pty(4)`_)
+- exist inside :ref:`Windows`
+- identified by ``%``, e.g. ``%313``
+
+.. _pseudoterminal: https://en.wikipedia.org/wiki/Pseudoterminal
+.. _pty(4): https://www.freebsd.org/cgi/man.cgi?query=pty&sektion=4

doc/servers.rst

@@ -1,12 +1,20 @@
 .. _Servers:
 
-You *can* have >1 servers running of tmux at the same time.
-
 =======
 Servers
 =======
 
+- identified by *socket path* and *socket name* 
+- may have >1 servers running of tmux at the same time.
+- hold :ref:`Sessions` (which hold :ref:`Windows`, which hold
+  :ref:`Panes`)
+
 In tmux, a server is automatically started on your behalf
 when you first run tmux.
 
-
+.. autoclass:: libtmux.Server
+    :members:
+    :inherited-members:
+    :private-members:
+    :show-inheritance:
+    :member-order: bysource

doc/sessions.rst

@@ -4,4 +4,6 @@
 Sessions
 ========
 
-In tmux,
+- exist inside :ref:`Servers`
+- contain :ref:`Windows` (which hold :ref:`Panes`)
+- identified by ``$``, e.g. ``$313``

doc/windows.rst

@@ -4,4 +4,6 @@
 Windows
 =======
 
-In tmux,
+- exist inside :ref:`Sessions`
+- contain :ref:`Panes`
+- identified by ``@``, e.g. ``@313``