Improve sphinx doc formatting

Author: rocky

Makefile

@@ -50,6 +50,10 @@ clean:
 dist: check-rst
 	bash ./admin-tools/make-dist-newer.sh
 
+#: HTML document via Sphinx
+doc html htmldoc:
+	$(MAKE) -C docs html
+
 #: Create source tarball
 sdist: check-rst
 	$(PYTHON) ./setup.py sdist

docs/commands/set/asmfmt.rst

@@ -8,10 +8,17 @@ Set Asmfmt
 
 Set the style of format to use in disassembly:
 
-classic:  fields: line, marker offset, opcode operand
-extended: above, but we try harder to get operand information from previous instructions
-bytes:  like classic but we show the instruction bytes after the offset
-extended-bytes:   bytes + extended
+``classic``:
+    has fields: *line* *marker* *offset*, and *opcode operand*
+
+``extended``:
+    like ``classic``, but we try harder to get operand information from previous instructions
+
+``bytes``:
+    like classic but we show the instruction bytes after the offset
+
+``extended-bytes``
+     ``bytes`` format along with *extended* format
 
 
 Examples:
@@ -23,4 +30,4 @@ Examples:
 
 .. seealso::
 
-   :ref:`show asmfmt <show_asmfmt>``
+   :ref:`show asmfmt <show_asmfmt>`

docs/commands/set/events.rst

@@ -10,13 +10,13 @@ Sets the events that the debugger will stop on. Event names are:
 .. hlist::
    :columns: 3
 
-   * `c_call`
-   * `c_exception`
-   * `c_return`
-   * `call`
-   * `exception`
-   * `line`
-   * `return`
+   * ``c_call``
+   * ``c_exception``
+   * ``c_return``
+   * `call``
+   * ``exception``
+   * ``line``
+   * ``return``
 
 `all` can be used as an abbreviation for listing all event names.
 

docs/commands/show/asmfmt.rst

@@ -16,4 +16,4 @@ Example:
 
 .. seealso::
 
-   :ref:`set_asmfmt <set_asmfmt>``
+   :ref:`set_asmfmt <set_asmfmt>`