--- a/doc/user_guide.txt	Fri Oct 10 00:40:16 2003 +0000
+++ b/doc/user_guide.txt	Fri Oct 10 04:35:26 2003 +0000
@@ -2,7 +2,7 @@
 User Guide
 ==========
 
-:Version: $Revision: 1.23 $
+:Version: $Revision: 1.24 $
 
 .. contents::
 
@@ -27,6 +27,11 @@
 Issue number 315 is referred to as "issue315". We call that label the
 item's *designator*.
 
+Items in the database are never deleted, they're just "retired". You
+can still refer to them by ID - hence removing an item won't break
+references to the item. It's just that the item won't appear in any
+listings.
+
 
 Accessing the Tracker
 ---------------------
@@ -473,6 +478,10 @@
 Mail gateway script command line
 --------------------------------
 
+Usage::
+
+  roundup-mailgw [[-C class] -S field=value]* <instance home> [method]
+
 The roundup mail gateway may be called in one of three ways:
 
  - with an instance home as the only argument,