standardize formatting in docs

docs/Plugins.rst

@@ -46,37 +46,39 @@ selected interactively with the ``blueprint gui`` command or, if the GUI is not
 used, starts at the active cursor location and extends right and down for the
 requested width and height.
 
-Usage:
+Usage::
 
     blueprint <width> <height> [<depth>] [<name> [<phases>]] [<options>]
     blueprint gui [<name> [<phases>]] [<options>]
 
 Examples:
 
-blueprint gui
+``blueprint gui``
     Runs `gui/blueprint`, the interactive blueprint frontend, where all
     configuration for a ``blueprint`` command can be set visually and
     interactively.
 
-blueprint gui bedrooms dig -\-cursor 108,100,150
+``blueprint 30 40 bedrooms``
-    Starts ``gui/blueprint`` with some configuration options preset to custom
-    values.
-
-blueprint 30 40 bedrooms
     Generates blueprints for an area 30 tiles wide by 40 tiles tall, starting
-    from the active cursor on the current z-level. Output is written to the
+    from the active cursor on the current z-level. Output is written to files
-    ``bedrooms.csv`` file in the ``blueprints`` directory.
+    with names matching the pattern ``bedrooms-PHASE.csv`` in the ``blueprints``
+    directory.
+
+``blueprint 30 40 bedrooms dig --cursor 108,100,150``
+    Generates only the ``bedrooms-dig.csv`` file from the previous example, and
+    the blueprint start coordinate is set to a specific value instead of using
+    the in-game cursor position.
 
 Positional Parameters:
 
-:width:   Width of the area (in tiles) to translate.
+:``width``:   Width of the area (in tiles) to translate.
-:height:  Height of the area (in tiles) to translate.
+:``height``:  Height of the area (in tiles) to translate.
-:depth:   Number of z-levels to translate. Positive numbers go *up* from the
+:``depth``:   Number of z-levels to translate. Positive numbers go *up* from the
     cursor and negative numbers go *down*. Defaults to 1 if not specified,
     indicating that the blueprint should only include the current z-level.
-:name:    Base name for blueprint files created in the ``blueprints`` directory.
+:``name``:    Base name for blueprint files created in the ``blueprints``
-          If no name is specified, "blueprint" is used by default. The string
+    directory. If no name is specified, "blueprint" is used by default. The
-          must contain some characters other than numbers so the name won't be
+    string must contain some characters other than numbers so the name won't be
     confused with the optional ``depth`` parameter.
 
 Phases:
@@ -85,21 +87,21 @@ If you want to generate blueprints only for specific phases, add their names to
 the commandline, anywhere after the blueprint base name. You can list multiple
 phases; just separate them with a space.
 
-:dig:    Generate quickfort ``#dig`` blueprints.
+:``dig``:    Generate quickfort ``#dig`` blueprints.
-:build:  Generate quickfort ``#build`` blueprints for constructions and
+:``build``:  Generate quickfort ``#build`` blueprints for constructions and
     buildings.
-:place:  Generate quickfort ``#place`` blueprints for placing stockpiles.
+:``place``:  Generate quickfort ``#place`` blueprints for placing stockpiles.
-:query:  Generate quickfort ``#query`` blueprints for configuring rooms.
+:``query``:  Generate quickfort ``#query`` blueprints for configuring rooms.
 
 If no phases are specified, all blueprints are created.
 
 Options:
 
-:-c, -\-cursor <x>,<y>,<z>:
+:``-c``, ``--cursor <x>,<y>,<z>``:
     Use the specified map coordinates instead of the current cursor position for
     the upper left corner of the blueprint range. If this option is specified,
     then an active game map cursor is not necessary.
-:-h, -\-help:
+:``-h``, ``--help``:
     Show command help text.
 
 .. _remotefortressreader: