* Renamed the "Extended message ID" field to "Exclusive message ID"

[citadel.git] / citadel / techdoc / delivery-list.txt

diff --git a/citadel/techdoc/delivery-list.txt b/citadel/techdoc/delivery-list.txt
index b6c3880dd6fc503a69eab8acfedf087aed639f5a..9395c9442ee43198516bee85e925b2eca98b4f8a 100644 (file)
--- a/citadel/techdoc/delivery-list.txt
+++ b/citadel/techdoc/delivery-list.txt
@@ -2,13 +2,15 @@ Description of the custom MIME type "application/x-citadel-delivery-list"
 
  This MIME type may be found in the outbound queue room on Citadel systems,
 which is typically called "__CitadelSMTPspoolout__".  The room is flagged as
-private, but we will eventually hide it even to Aides.  
+a "system" room, which means that it's completely hidden to everyone, although
+an Aide can get to it if the full name is specified (but unlike a normal
+hidden room, it does not appear in the known rooms list on subsequent visits).
  
  Messages in this format contain delivery instructions.  Therefore, for each
 message in the queue to be delivered to one or more recipients, there will be
 *two* messages in the room: one containing the actual message, and the other
 containing delivery instructions.  It is expected that the instructions
-message may be replaced at any time (using an Extended ID field) if delivery
+message may be replaced at any time (using an Exclusive ID field) if delivery
 to only some of the recipients has been accomplished.
  
  Citadel keeps reference counts of each message on disk.  Therefore if a
@@ -47,6 +49,16 @@ each line.
     attempt.
  
  
+ INSTRUCTION:  retry
+ SYNTAX:       retry|9999999
+ DESCRIPTION:
+    Citadel does not retry SMTP delivery at a fixed interval.  Instead, it
+starts at a nominal interval (15 minutes by default) and then doubles the
+interval after each failed attempt.  This instruction contains the interval
+which should currently be followed (and doubled again, if the next delivery
+fails).
+  
+  
  INSTRUCTION:  bounceto
  SYNTAX:       bounceto|Big Bad Sender[@host]
  DESCRIPTION:
@@ -72,7 +84,7 @@ each line.
  
  
  INSTRUCTION:  remote
- SYNTAX:       remote|billg@microsoft.com|0|delivery status message
+ SYNTAX:       remote|friko@mumjiboolean.com|0|delivery status message
  DESCRIPTION:
     Names a recipient on a remote system to which the message should be
     delivered.  The third parameter may contain any of the following values: