docs(glossary): Use markdown

Author: tony

docs/glossary.md

@@ -2,67 +2,63 @@
 
 # Glossary
 
-```{eval-rst}
-.. glossary::
+```{glossary}
 
-    libtmux
-        Python library for interfacing with tmux through its objects.
+tmuxp
+    A tool to manage workspaces with tmux. A pythonic abstraction of
+    tmux.
 
-    tmuxp
-        A tool to manage workspaces with tmux, built on libtmux.
+tmux
+tmux(1)
+    The tmux binary. Used internally to distinguish tmuxp is only a
+    layer on top of tmux.
 
-    tmux(1)
-        The tmux binary. Used internally to distinguish tmuxp is only a
-        layer on top of tmux.
+kaptan
+    configuration management library, see [kaptan on github](https://github.com/emre/kaptan).
 
-    kaptan
-        configuration management library, see `kaptan on github`_.
+Server
+    Tmux runs in the background of your system as a process.
 
-    Server
-        Tmux runs in the background of your system as a process.
+    The server holds multiple {term}`Session`. By default, tmux
+    automatically starts the server the first time ``$ tmux`` is ran.
 
-        The server holds multiple :term:`Session`. By default, tmux
-        automatically starts the server the first time ``$ tmux`` is ran.
+    A server contains {term}`session`'s.
 
-        A server contains :term:`session`'s.
+    tmux starts the server automatically if it's not running.
 
-        tmux starts the server automatically if it's not running.
+    Advanced cases: multiple can be run by specifying
+    ``[-L socket-name]`` and ``[-S socket-path]``.
 
-        Advanced cases: multiple can be run by specifying
-        ``[-L socket-name]`` and ``[-S socket-path]``.
+Client
+    Attaches to a tmux {term}`server`.  When you use tmux through CLI,
+    you are using tmux as a client.
 
-    Client
-        Attaches to a tmux :term:`server`.  When you use tmux through CLI,
-        you are using tmux as a client.
+Session
+    Inside a tmux {term}`server`.
 
-    Session
-        Inside a tmux :term:`server`.
+    The session has 1 or more {term}`Window`. The bottom bar in tmux
+    show a list of windows. Normally they can be navigated with
+    ``Ctrl-a [0-9]``, ``Ctrl-a n`` and ``Ctrl-a p``.
 
-        The session has 1 or more :term:`Window`. The bottom bar in tmux
-        show a list of windows. Normally they can be navigated with
-        ``Ctrl-a [0-9]``, ``Ctrl-a n`` and ``Ctrl-a p``.
+    Sessions can have a ``session_name``.
 
-        Sessions can have a ``session_name``.
+    Uniquely identified by ``session_id``.
 
-        Uniquely identified by ``session_id``.
+Window
+    Entity of a {term}`session`.
 
-    Window
-        Entity of a :term:`session`.
+    Can have 1 or more {term}`pane`.
 
-        Can have 1 or more :term:`pane`.
+    Panes can be organized with a layouts.
 
-        Panes can be organized with a layouts.
+    Windows can have names.
 
-        Windows can have names.
+Pane
+    Linked to a {term}`Window`.
 
-    Pane
-        Linked to a :term:`Window`.
+    a pseudoterminal.
 
-        a pseudoterminal.
-
-    Target
-        A target, cited in the manual as ``[-t target]`` can be a session,
-        window or pane.
-
-.. _kaptan on github: https://github.com/emre/kaptan
+Target
+    A target, cited in the manual as ``[-t target]`` can be a session,
+    window or pane.
 ```