X-Git-Url: https://git.distorted.org.uk/~mdw/qmail/blobdiff_plain/2117e02ec495fdfd6e96b39778b701a5bcff8aa5..HEAD:/dot-qmail.9

diff --git a/dot-qmail.9 b/dot-qmail.9
index 936067c..651726a 100644
--- a/dot-qmail.9
+++ b/dot-qmail.9
@@ -39,13 +39,34 @@ A comment line begins with a number sign:
 .EE
 
 .B qmail-local
-ignores the line.
+ignores the line.  However,
+.BR qmail-valid-addresses (8)
+interprets some markers in comments.  If the first line of a
+.B .qmail
+file begins `#!' then the address (or addresses) controlled by the file
+are considered invalid, and any attempt to send to them is refused by
+.BR qmail-smtpd (8).
+(Note: This doesn't prevent local users sending mail directly.  This
+feature can therefore be used to experiment with mail rules before
+allowing the entire Internet to break them.)  If the first line of a
+.B .qmail
+file begins `#?' then 
+.BR qmail-smtpd (8)
+will consult a Userv service
+.BI addrcheck: ext
+to decide whether addresses matched by the extension
+.I ext
+are valid.  The service is passed many arguments, though the first two
+are the most interesting.  The first is the local-part tail (i.e., the
+bit that matched
+.BR default )
+and the second is the envelope sender.
 .TP 5
 (2)
 A program line begins with a vertical bar:
 
 .EX
-     |/usr/ucb/vacation djb
+     |preline /usr/ucb/vacation djb
 .EE
 
 .B qmail-local
@@ -152,6 +173,25 @@ It reliably stores the incoming message in that directory.
 See
 .B maildir(5)
 for more details.
+.TP 5
+(6)
+An
+.I sender
+line begins with a less-than-sign `<'.  The remainder of the line is set
+as the new envelope sender for any forwarding done through this file.
+.TP 5
+(7)
+An
+.I environment
+line begins with an exclamation mark `!'.  If the remainder of the line
+has the form
+.IB var = value
+then the environment variable
+.I var
+is set to 
+.I value
+for the following program deliveries.  If there is no equals sign, the
+named environment variable is deleted.
 .PP
 If
 .B .qmail
@@ -173,10 +213,10 @@ If
 is completely empty (0 bytes long), or does not exist,
 .B qmail-local
 follows the
-.I aliasempty
+.I defaultdelivery
 instructions set by your system administrator;
 normally
-.I aliasempty
+.I defaultdelivery
 is
 .BR ./Mailbox ,
 so
@@ -224,7 +264,7 @@ It's a good idea to test your new
 file as follows:
 
 .EX
-     qmail-local -n $USER $HOME $USER '' '' '' ''
+     qmail-local -n $USER ~ $USER '' '' '' '' ./Mailbox
 .EE
 .SH "EXTENSION ADDRESSES"
 In the
@@ -274,7 +314,7 @@ If
 is completely empty,
 .B qmail-local
 follows the
-.I aliasempty
+.I defaultdelivery
 instructions set by your system administrator.
 
 If