--- a/docs/manual.sgml	Wed Apr 08 07:02:40 2009 +0000
+++ b/docs/manual.sgml	Wed Apr 08 07:12:42 2009 +0000
@@ -2670,10 +2670,38 @@
 
 <section id="usage-rpouch"><title>Reagent Pouch handler (gm-rpouch.tf)</title>
 <para>
-
+This module provides utilities for reagent pouch handling, especially useful
+for mages and merchants. It also has a reagent pouch mangler/beautifier,
+which attempts to make the pouch contents more readable.
+</para>
+
+<para>
+Example output (uncoloured) of looking at a reagent pouch:
 </para>
-
 <screen>
+This is a large pouch for the storing of reagents for spells. You can store
+reagents over reboots in this. It cannot hold anything else.
+Syntax: store &lt;item&gt; in &lt;this&gt;
+        extract [amount] &lt;item&gt; from &lt;this&gt; take &lt;power/standard/poor&gt;
+        set_default_reagent &lt;this&gt; to &lt;power/standard/poor&gt;
+transfer &lt;number&gt; &lt;reagent&gt; from &lt;here&gt; to &lt;there&gt; [take &lt;power level&gt;]
+Some commands allow the use of 'all' in places.
+It is labeled as 'pussi'.
+The label can be set with 'label' command.
+  578 | Acid Blast                ( 578,   0,   0) (Olivine powder)
+  477 | Acid Storm                ( 477,   0,   0) (Interlocked rings)
+  436 | Blast Vacuum              ( 436,   0,   0) (Bronze marble)
+  417 | Lightning Shield          ( 417,   0,   0) (Iron rod)
+  397 | Armour of Aether          ( 397,   0,   0) (Highsteel disc)
+  388 | Magic Eruption            ( 388,   0,   0) (Platinum hammer)
+  341 | Lava Blast                ( 341,   0,   0) (Granite sphere)
+  272 | Electrocution             ( 272,   0,   0) (Electrum wire)
+  263 | Aura of Wind              ( 263,   0,   0) (Leather bag)
+   91 | Golden Arrow              (  91,   0,   0) (Copper rod)
+   71 | Shield of Detoxification  (  71,   0,   0) (Amethyst crystal)
+It is surrounded by a yellow glow.
+This item is in superb condition.
+It looks very very heavy.
 </screen>
 
 <note><para>