fix some doc formatting

docs/devel/click-monitor.rst

@@ -12,4 +12,5 @@ Usage
 -----
 
 ::
+
     enable devel/click-monitor

docs/gui/color-schemes.rst

@@ -7,7 +7,7 @@ gui/color-schemes
 
 This is an in-game interface for `color-schemes`, which allows you to modify the
 colors in the Dwarf Fortress interface. This script must be called from either
-the title screen (shown when you first start the Dwarf Fortress game) or a
+the title screen (shown when you first start the Dwarf Fortress game) or the
 fortress main map screen.
 
 Usage

docs/modtools/change-build-menu.rst

@@ -17,7 +17,8 @@ your changes each time the world loads.
 Just to be clear: You CANNOT use this script AT ALL if there is no world
 loaded!
 
-**Usage:**
+Usage
+-----
 
 ``enable modtools/change-build-menu``:
 
@@ -92,7 +93,8 @@ loaded!
     changes you no longer want/need.
 
 
-**Module Usage:**
+Module Usage
+------------
 
 To use this script as a module put the following somewhere in your own script:
 

docs/modtools/create-tree.rst

@@ -7,7 +7,10 @@ modtools/create-tree
 
 Spawns a tree.
 
-Usage::
+Usage
+-----
+
+::
 
     -tree treeName
         specify the tree to be created

docs/modtools/create-unit.rst

@@ -5,7 +5,12 @@ modtools/create-unit
     :summary: Create arbitrary units.
     :tags: unavailable dev
 
-Creates a unit.  Usage::
+Creates a unit.
+
+Usage
+-----
+
+::
 
     -race raceName
         (obligatory)

docs/modtools/extra-gamelog.rst

@@ -8,7 +8,9 @@ modtools/extra-gamelog
 This script writes extra information to the gamelog.
 This is useful for tools like :forums:`Soundsense <60287>`.
 
-Usage::
+Usage
+-----
+
+::
 
     modtools/extra-gamelog enable
-    modtools/extra-gamelog disable

docs/modtools/force.rst

@@ -7,7 +7,10 @@ modtools/force
 
 This tool triggers events like megabeasts, caravans, and migrants.
 
-Usage::
+Usage
+-----
+
+::
 
     -eventType event
         specify the type of the event to trigger

docs/modtools/if-entity.rst

@@ -11,18 +11,19 @@ To use this script effectively it needs to be called from "raw/onload.init".
 Calling this from the main dfhack.init file will do nothing, as no world has
 been loaded yet.
 
-Usage:
+Usage
+-----
 
-- ``id``:
+``id``
     Specify the entity ID to match
-- ``cmd [ commandStrs ]``:
+``cmd [ commandStrs ]``
     Specify the command to be run if the current entity matches the entity
     given via -id
 
 All arguments are required.
 
-Example:
+Example
+-------
 
-- Print a message if you load an elf fort, but not a dwarf, human, etc. fort::
-
-    if-entity -id "FOREST" -cmd [ lua "print('Dirty hippies.')" ]
+``if-entity -id "FOREST" -cmd [ lua "print('Dirty hippies.')" ]``
+    Print a message if you load an elf fort, but not a dwarf, human, etc. fort.

docs/modtools/interaction-trigger.rst

@@ -10,7 +10,10 @@ scanning the announcements for the correct attack verb, so the attack verb
 must be specified in the interaction. It includes an option to suppress this
 announcement after it finds it.
 
-Usage::
+Usage
+-----
+
+::
 
     -clear
         unregisters all triggers

docs/modtools/projectile-trigger.rst

@@ -5,7 +5,12 @@ modtools/projectile-trigger
     :summary: Run DFHack commands when projectiles hit their targets.
     :tags: unavailable dev
 
-This triggers dfhack commands when projectiles hit their targets.  Usage::
+This triggers dfhack commands when projectiles hit their targets.
+
+Usage
+-----
+
+::
 
     -clear
         unregister all triggers

docs/modtools/reaction-product-trigger.rst

@@ -6,7 +6,12 @@ modtools/reaction-product-trigger
     :tags: unavailable dev
 
 This triggers dfhack commands when reaction products are produced, once per
-product.  Usage::
+product.
+
+Usage
+-----
+
+::
 
     -clear
         unregister all reaction hooks