diff --git a/docs/plugins/search.rst b/docs/plugins/search.rst
index 57b9e5df4..c8f5d68b3 100644
--- a/docs/plugins/search.rst
+++ b/docs/plugins/search.rst
@@ -1,40 +1,44 @@
-
 .. _search-plugin:
 
 search
 ======
-The search plugin adds search to the Stocks, Animals, Trading, Stockpile,
-Noble (assignment candidates), Military (position candidates), Burrows
-(unit list), Rooms, Announcements, Job List and Unit List screens.
+Tags:
+
+The search plugin adds search capabilities to the Stocks, Animals, Trading,
+Stockpile, Noble (assignment candidates), Military (position candidates),
+Burrows (unit list), Rooms, Announcements, Job List, and Unit List screens.
+
+Usage::
+
+    enable search
 
 .. image:: ../images/search.png
 
 Searching works the same way as the search option in :guilabel:`Move to Depot`.
-You will see the Search option displayed on screen with a hotkey (usually :kbd:`s`).
-Pressing it lets you start typing a query and the relevant list will start
-filtering automatically.
+You will see the Search option displayed on screen with a hotkey
+(usually :kbd:`s`). Pressing it lets you start typing a query and the relevant
+list will start filtering automatically.
 
-Pressing :kbd:`Enter`, :kbd:`Esc` or the arrow keys will return you to browsing the now
-filtered list, which still functions as normal. You can clear the filter
-by either going back into search mode and backspacing to delete it, or
-pressing the "shifted" version of the search hotkey while browsing the
-list (e.g. if the hotkey is :kbd:`s`, then hitting :kbd:`Shift`:kbd:`s` will clear any
-filter).
+Pressing :kbd:`Enter`, :kbd:`Esc` or the arrow keys will return you to browsing
+the now filtered list, which still functions as normal. You can clear the filter
+by either going back into search mode and backspacing to delete it, or pressing
+the "shifted" version of the search hotkey while browsing the list (e.g. if the
+hotkey is :kbd:`s`, then hitting :kbd:`Shift`:kbd:`s` will clear any filter).
 
 Leaving any screen automatically clears the filter.
 
-In the Trade screen, the actual trade will always only act on items that
-are actually visible in the list; the same effect applies to the Trade
-Value numbers displayed by the screen. Because of this, the :kbd:`t` key is
-blocked while search is active, so you have to reset the filters first.
-Pressing :kbd:`Alt`:kbd:`C` will clear both search strings.
+In the Trade screen, the actual trade will always only act on items that are
+actually visible in the list; the same effect applies to the Trade Value numbers
+displayed by the screen. Because of this, the :kbd:`t` key is blocked while
+search is active, so you have to reset the filters first. Pressing
+:kbd:`Alt`:kbd:`C` will clear both search strings.
 
 In the stockpile screen the option only appears if the cursor is in the
 rightmost list:
 
 .. image:: ../images/search-stockpile.png
 
-Note that the 'Permit XXX'/'Forbid XXX' keys conveniently operate only
-on items actually shown in the rightmost list, so it is possible to select
-only fat or tallow by forbidding fats, then searching for fat/tallow, and
-using Permit Fats again while the list is filtered.
+Note that the 'Permit XXX'/'Forbid XXX' keys conveniently operate only on items
+actually shown in the rightmost list, so it is possible to select only fat or
+tallow by forbidding fats, then searching for fat/tallow, and using Permit Fats
+again while the list is filtered.