More docs cleanups

docs/integrations.rst

@@ -65,7 +65,9 @@ System and data visualisation tools
 
 `gnuplot <http://www.gnuplot.info/>`_
     a graphing and data visualization tool that can be made to display its
-    output in kitty with the following bash snippet::
+    output in kitty with the following bash snippet:
+
+    .. code-block:: sh
 
         function iplot {
             cat <<EOF | gnuplot
@@ -79,7 +81,9 @@ System and data visualisation tools
             EOF
         }
 
-   Add this to bashrc and then to plot a function, simply do::
+    Add this to bashrc and then to plot a function, simply do:
+
+    .. code-block:: sh
 
         iplot 'sin(x*3)*exp(x*.2)'
 

docs/kittens/broadcast.rst

@@ -1,6 +1,8 @@
-broadcast - type text in all kitty windows
+broadcast
 ==================================================
 
+*Type text in all kitty windows simultaneously*
+
 The ``broadcast`` kitten can be used to type text simultaneously in
 all kitty windows (or a subset as desired).
 

docs/kittens/clipboard.rst

@@ -1,6 +1,8 @@
-clipboard - copy/paste to the system clipboard
+clipboard
 ==================================================
 
+*Copy/paste to the system clipboard from shell scripts*
+
 .. highlight:: sh
 
 

docs/layouts.rst

@@ -27,9 +27,6 @@ you can switch layouts using :sc:`next_layout`. To control which layouts
 are available use :opt:`enabled_layouts`, the first listed layout becomes
 the default. Individual layouts and how to use them are described below.
 
-.. contents::
-   :local:
-
 
 The Stack Layout
 ------------------

docs/marks.rst

@@ -89,12 +89,11 @@ The syntax of the :code:`toggle_marker` command is::
 
 Here :code:`marker-type` is one of:
 
-    * :code:`text` - simple substring matching
+* :code:`text` - simple substring matching
-    * :code:`itext` - case-insensitive substring matching
+* :code:`itext` - case-insensitive substring matching
-    * :code:`regex` - A python regular expression
+* :code:`regex` - A python regular expression
-    * :code:`iregex` - A case-insensitive python regular expression
+* :code:`iregex` - A case-insensitive python regular expression
-    * :code:`function` - An arbitrary function defined in a python file, see
+* :code:`function` - An arbitrary function defined in a python file, see :ref:`marker_funcs`.
-      :ref:`marker_funcs`.
 
 .. _marker_funcs:
 

kittens/query_terminal/main.py

@@ -209,11 +209,12 @@ Note that when calling this from another program, be very
 careful not to perform any I/O on the terminal device
 until the kitten exits.
 
-Available queries are::
+Available queries are:
 
 {}
-'''.format('  ' + '\n  '.join(
+
-    f'{name}: {c.help_text}' for name, c in all_queries.items()))
+'''.format('\n'.join(
+    f'``{name}``\n  {c.help_text}\n' for name, c in all_queries.items()))
 usage = '[query1 query2 ...]'