diff --git a/debian/docs/koha-common.xml b/debian/docs/koha-common.xml
index bbef4f2f9c..4dc21799ce 100644
--- a/debian/docs/koha-common.xml
+++ b/debian/docs/koha-common.xml
@@ -202,9 +202,17 @@
           <para>Run a command for each Koha instance. Takes the same arguments as koha-list.</para>
         </listitem>
       </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-shell</option></term>
+        <listitem>
+          <para>This command behaves something like su(1), but provides you with a shell as the koha user, and with the environment pointing to the right places.</para>
+        </listitem>
+      </varlistentry>
     </variablelist>
     </refsect2>
   </refsect1>
+
   
   <refsect1><title>Bugs</title>
   <para>The scripts are a bit fragile. If something goes wrong, they do not clean up after themselves.</para>