outline for new gui/teleport

docs/gui/teleport.rst

@@ -2,11 +2,14 @@ gui/teleport
 ============
 
 .. dfhack-tool::
-    :summary: Teleport a unit anywhere.
-    :tags: unavailable
+    :summary: Teleport units anywhere.
+    :tags: fort armok units
 
-This tool is a front-end for the `teleport` tool. It allows you to interactively
-choose a unit to teleport and a destination tile using the in-game cursor.
+This tool allows you to interactively select units to teleport by drawing boxes
+around them on the map. Double clicking on a destination tile will teleport the selected units there.
+
+If a unit is already selected in the UI when you run `gui/teleport`, it will be
+pre-selected for teleport.
 
 Usage
 -----