Improvements.

* mflib/verp.mf (verp_extract_user): Pass email as the first
argument.
* doc/mailfromd.texi: Update.
* doc/Makefile.am: Add pmult.texi
* doc/pmult.texi: New file.
* mfd/lex.l: %% and $$ in quoted strings are replaced by single %
and $, correspondingly.
* NEWS: Update.


git-svn-id: file:///svnroot/mailfromd/trunk@1723 7a8a7f39-df28-0410-adc6-e0d955640f24

1 files changed, 58 insertions, 5 deletions

diff --git a/doc/mailfromd.texi b/doc/mailfromd.texi
index 0a0edbe0..91c93d0b 100644
--- a/doc/mailfromd.texi
+++ b/doc/mailfromd.texi
@@ -3140,7 +3140,7 @@ sign (as @option{--file=arg}), or is given as the next word in the
 command line (e.g. @option{--file arg}).
 
 If the option argument is optional, i.e. it may not necessarily be
-given, then only the first form is used (i.e. either @option{-farg} or
+given, then only the first form is allowed (i.e. either @option{-farg} or
 @option{--file=arg}.
 
 The @samp{--} command line argument ends the option list.  Any
@@ -3277,7 +3277,7 @@ definiton.
 
 @anchor{vaptr}
 @cindex vaptr
-The special language construct is provided to supply the second
+A special language construct is provided to supply the second
 argument (@var{argv}) to @code{getopt} and similar functions:
 
 @smallexample
@@ -6347,7 +6347,7 @@ from the message envelope.  This allows @acronym{MFL} scripts to
 redirect messages to another addresses.
 
 @deftypefn {Built-in Function} void rcpt_add (string @var{address})
-Add e-mail @var{address} to the envelope.
+Add the e-mail @var{address} to the envelope.
 @end deftypefn
 
 @deftypefn {Built-in Function} void rcpt_delete (string @var{address})
@@ -6592,6 +6592,18 @@ descriptior @var{nsmg} must be obtained from a previous call to
 @subsubsection Message Functions
 @UNREVISED{}
 
+@deftypefn {Built-in Function} number message_size (number @var{nmsg})
+Return the size of the message @var{nmsg}, in bytes.
+@end deftypefn
+
+@deftypefn {Built-in Function} number message_body_size (number @var{nmsg})
+Return the size, in bytes, of the body of message @var{nmsg}.
+@end deftypefn
+
+@deftypefn {Built-in Function} number message_header_size (number @var{nmsg})
+Return the size, in bytes of the headers of message @var{nmsg}.
+@end deftypefn
+
 @deftypefn {Built-in Function} number message_body_lines (number @var{nmsg})
 Return number of lines in the body of message referred to by
 descriptor @var{nmsg}.
@@ -7290,6 +7302,47 @@ there are no such record, return without signalling error.
 rest of database functions (see above).
 @end deftypefn
 
+The following functions provide a sequential access to the contents of
+a @acronym{DBM} database:
+
+@deftypefn {Built-in Function} number dbfirst (string @var{name})
+Start sequential access to the database @var{name}.  The return value
+is an opaque identifier, which is used by the remaining sequential
+access functions.  This number is @samp{0} if the database is empty.
+@end deftypefn
+
+@deftypefn {Built-in Function} number dbnext (number @var{dn})
+Select next record form the database.  The argument @var{dn} is the
+access identifier, returned by a previous call to @code{dbfirst} or
+@code{dbnext}.
+
+Returns new access identifier.  This number is @samp{0} if all records
+in the database have been visited.
+@end deftypefn
+
+ The usual approach for iterating over all records in a database
+@var{dbname} is:
+
+@smallexample
+  loop for number dbn dbfirst(@var{dbname})
+  do
+    @dots{}
+  done while dbnext(%dbn)
+@end smallexample
+
+  The following two functions can be used to access values of the
+currently selected database record.  Their argument, @var{dn}, is the
+access identifier, returned by a previous call to @code{dbfirst} or
+@code{dbnext}.
+
+@deftypefn {Built-in Function} string dbkey (number @var{dn})
+Return the key from the selected database record.
+@end deftypefn
+
+@deftypefn {Built-in Function} string dbvalue (number @var{dn})
+Return the value from the selected database record.
+@end deftypefn
+
 @deftypefn {Built-in Function} number db_expire_interval (string @var{fmt})
   The @var{fmt} argument is a database format identifier
 (@pxref{Database Formats}).  If it is valid, the function returns the
@@ -10859,7 +10912,7 @@ statement;
 @anchor{poll}
 @cindex @code{poll} keyword
 @cindex @code{poll} statement, defined
-  The special form of the @var{condition} is @code{poll} keyword,
+  A special form of the @var{condition} is @code{poll} keyword,
 whose syntax is:
 
 @smallexample
@@ -12473,7 +12526,7 @@ f, @{client_addr@}
 
 @node pmult, pies, smap, Top
 @chapter Pmilter multiplexor program.
-@UNREVISED{}
+@include pmult.texi
 
 @node pies, Reporting Bugs, pmult, Top
 @chapter Program execution supervisor.