aboutsummaryrefslogtreecommitdiff
path: root/doc/mailfromd.texi
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2008-12-26 10:18:53 +0000
committerSergey Poznyakoff <gray@gnu.org.ua>2008-12-26 10:18:53 +0000
commit6106d7f2c61617185a1150a0cc5ba66e3096ec77 (patch)
treef4f6da58428fee44fc79c1a876d0cbd7b2e901d5 /doc/mailfromd.texi
parent3faf6f97adb88ad88aea7fdffb683f737fe5b068 (diff)
downloadmailfromd-6106d7f2c61617185a1150a0cc5ba66e3096ec77.tar.gz
mailfromd-6106d7f2c61617185a1150a0cc5ba66e3096ec77.tar.bz2
Version 5.0
* configure.ac, NEWS: Version 5.0. * doc/mailfromd.texi, doc/pies.texi, doc/pmult.texi: Update. * doc/Makefile.am (check-builtins): Account for MF_DEFUN_VARARGS_NO_PROM. git-svn-id: file:///svnroot/mailfromd/trunk@1771 7a8a7f39-df28-0410-adc6-e0d955640f24
Diffstat (limited to 'doc/mailfromd.texi')
-rw-r--r--doc/mailfromd.texi101
1 files changed, 58 insertions, 43 deletions
diff --git a/doc/mailfromd.texi b/doc/mailfromd.texi
index 5d0ccb00..8b2b4f83 100644
--- a/doc/mailfromd.texi
+++ b/doc/mailfromd.texi
@@ -753,11 +753,9 @@ undertake in order to configure and build the package.
packages on your machine:
@enumerate A
-@item GNU mailutils version 1.9.93 or newer.
+@item GNU mailutils version 2.0 or newer.
It is available from @uref{http://www.gnu.org/software/mailutils}.
-@FIXME{The version 1.9.93 is an alpha version. Its snapshots are
-available from @uref{ftp://download.gnu.org.ua/pub/alpha/mailutils}.}
@item A @acronym{DBM} library.
@anchor{DBM}
@@ -1041,38 +1039,15 @@ the corresponding section below.
@node 440-500
@section Upgrading from 4.4 to 5.0
@cindex Upgrading from 4.4 to 5.0
-@UNREVISED{}
- This version requires @uref{http://www.gnu.org/software/mailutils,
-GNU mailutils} version 1.9.90 or later. At the time of this writing
-(@value{UPDATED}) this version is available from
-@uref{http://alpha.gnu.org/gnu/mailutils}. The fact that it is
-distributed via @samp{alpha} site does not mean it is not mature (on
-the contrary: by now it has been installed on several production sites
-with more than 20,000 users each, and is running without any
-noticeable problem). The reason for this is very simple: I lack time
-to update the mailutils documentation, and without the proper
-documentation I do not consider the package a candidate for a new
-release. By the time you read this, a newer version may well have
-appeared. Do not fear to try it. These versions will differ in minor
-details only (e.g. adding some new translations or the like), and the
-stable version (Mailutils 2.0) will appear as soon as I finish its
-documentation. That being said, you are invited to download the
-latest version of GNU Mailutils from @uref{alpha.gnu.org}, try it out
-and compile @command{Mailfromd} version @value{VERSION} with it.
-
- For this same reason, I'd ask you to bear with the lacks in the
-present @command{Mailfromd} documentation. I will try to fill these
-as soon as I cope with my problems and gather enough time and courage
-to finish the docs. And in the meantime I'd like to assure you that I
-always have both for developing the code, fixing bugs and aswering
-your questions, so feel free to report bugs and ask for help anytime
-(@pxref{Reporting Bugs}).
-
- Returning to the @command{Mailfromd} itself, the major differences
-of version 5.0 (or, better said @value{VERSION}, which you have
-downloaded) are the following:
+ This version of Mailfromd requires
+@uref{http://www.gnu.org/software/mailutils, GNU mailutils} version
+2.0 or later.
+ Upgrading from version 4.4 to 5.0 requires no additional
+changes. The major differences between these two versions are
+summarized below:
+
@enumerate 1
@item Support for @samp{MeTA1}.
@@ -1081,13 +1056,37 @@ downloaded) are the following:
@item New @acronym{MFL} functions.
@enumerate a
-@item @xref{Message functions}.
-@item @xref{Mailbox functions}.
-@item @xref{Mail body functions}.
-@item @xref{Header modification functions}.
-@item @xref{Quarantine functions}.
+@item Message functions. @xref{Message functions}.
+@item Mailbox functions. @xref{Mailbox functions}.
+@item Mail body functions. @xref{Mail body functions}.
+@item Header modification functions. @xref{Header modification functions}.
+@item Envelope modification functions. @xref{Envelope modification functions}.
+@item Quarantine functions. @xref{Quarantine functions}.
+@item @code{getopt} and @code{varptr}. @xref{getopt}.
+@item Macro access functions. @xref{Macro access}.
+@item Character type functions. @xref{Character Type}.
+@item New string functions (@pxref{String manipulation}):
+@code{verp_extract_user}, @code{sa_format_report_header},
+@code{sa_format_score}.
+@item Sequential access to DBM files. @xref{dbm-seq}.
@end enumerate
+@item Changes in @acronym{MFL}
+
+@enumerate 1
+@item @xref{variadic functions}.
+@item @xref{function alias}.
+@end enumerate
+
+@item New operation mode: @xref{Run Mode}.
+
+@item Improved stack growth technique.
+
+The stack can be grown either by fixed size blocks, or
+exponentially. Upper limit can be specified. @xref{stacksize}.
+
+@item Milter ports can be specified using @acronym{URL} notation.
+
@item Removed deprecated features.
Support for some deprecated features has been withdrawn. These are:
@@ -3068,8 +3067,8 @@ do
done
@end smallexample
-This function prints all its arguments (@xref{variable number of
-arguments}, for a detailed description of functions with variable
+This function prints all its arguments (@xref{variadic functions}, for
+a detailed description of functions with variable
number of aruments). Now running:
@smallexample
@@ -6228,6 +6227,19 @@ Example:
@code{revip("127.0.0.1") @result{} "1.0.0.127"}
@end deftypefn
+@deftypefn {Library Function} string verp_extract_user (string @var{email}, @
+ string @var{domain})
+
+If @var{email} is a valid @acronym{VERP}-style email address for
+@var{domain}, this function returns the user name, corresponding to that email.
+Otherwise, it returns empty string.
+
+@smallexample
+verp_extract_user("gray=gnu.org.ua@@tuhs.org", 'gnu\..*')
+ @result{} "gray"
+@end smallexample
+@end deftypefn
+
@node String formatting
@subsubsection String formatting
@@ -6467,7 +6479,6 @@ Checks for hexadecimal digits, i.e. one of @samp{0}, @samp{1},
@node Envelope modification functions
@subsubsection Envelope Modification Functions
-@UNREVISED{}
Envelope modification functions add or delete recipient addresses
from the message envelope. This allows @acronym{MFL} scripts to
@@ -7450,6 +7461,7 @@ there are no such record, return without signalling error.
rest of database functions (see above).
@end deftypefn
+@anchor{dbm-seq}
The following functions provide a sequential access to the contents of
a @acronym{DBM} database:
@@ -9118,9 +9130,11 @@ optional argument for which no actual parameter was supplied, results
in an undefined value, so be sure to check whether a parameter is
passed before dereferencing it.
-@anchor{variable number of arguments}
+@anchor{variadic functions}
+@cindex variadic function
@cindex variable number of arguments
- A function can also take variable number of arguments. This is
+ A function can also take variable number of arguments (such
+functions are called @dfn{variadic}). This is
indicated by the use of ellipsis as the last abstract argument. The
statement below defines a funtion @code{foo} taking one mandatory, one
optional and any number of additional arguments:
@@ -9207,6 +9221,7 @@ done
@end group
@end smallexample
+@anchor{function alias}
@cindex aliases
@kwindex alias
A function may have several names. An alernative name (or

Return to:

Send suggestions and report system problems to the System administrator.