update docs for embark-tools

docs/plugins/embark-assistant.rst

@@ -11,7 +11,7 @@ the current embark region. You will also have access to a site selection tool
 with far more options than DF's vanilla search tool.
 
 If you enable the plugin, you'll also be able to invoke ``embark-assistant``
-with the :kdb:`A` key on the pre-embark screen.
+with the :kbd:`A` key on the pre-embark screen.
 
 Usage::
 

docs/plugins/embark-tools.rst

@@ -1,12 +1,32 @@
 embark-tools
 ============
-A collection of embark-related tools. Usage and available tools::
+Tags:
+:dfhack-keybind:`embark-tools`
 
-    embark-tools enable/disable tool [tool]...
+:index:`Extend the embark screen functionality.
+<embark-tools; Extend the embark screen functionality.>`
 
-:anywhere:      Allows embarking anywhere (including sites, mountain-only biomes,
-                and oceans). Use with caution.
-:mouse:         Implements mouse controls (currently in the local embark region only)
-:sand:          Displays an indicator when sand is present in the currently-selected
-                area, similar to the default clay/stone indicators.
-:sticky:        Maintains the selected local area while navigating the world map
+Usage::
+
+    enable embark-tools
+    embark-tools enable|disable all
+    embark-tools enable|disable <tool> [<tool> ...]
+
+Avaliable tools are:
+
+``anywhere``
+    Allows embarking anywhere (including sites, mountain-only biomes, and
+    oceans). Use with caution.
+``mouse``
+    Implements mouse controls (currently in the local embark region only).
+``sand``
+    Displays an indicator when sand is present in the currently-selected area,
+    similar to the default clay/stone indicators.
+``sticky``
+    Maintains the selected local area while navigating the world map.
+
+Example
+-------
+
+``embark-tools enable all``
+    Enable all embark screen extensions.

plugins/embark-tools.cpp

@@ -752,20 +752,10 @@ DFhackCExport command_result plugin_init (color_ostream &out, std::vector <Plugi
     add_tool(new MouseControl);
     add_tool(new SandIndicator);
     add_tool(new StablePosition);
-    std::string help = "";
-    help += "embark-tools (enable/disable) tool [tool...]\n"
-            "Tools:\n";
-    FOR_ITER_TOOLS(iter)
-    {
-        help += ("  " + iter->second->getId() + ": " + iter->second->getDesc() + "\n");
-    }
     commands.push_back(PluginCommand(
         "embark-tools",
-        "A collection of embark tools",
-        embark_tools_cmd,
-        false,
-        help.c_str()
-    ));
+        "Extend the embark screen functionality.",
+        embark_tools_cmd));
     return CR_OK;
 }