diff options
author | Sergey Poznyakoff <gray@gnu.org.ua> | 2008-12-26 10:18:53 +0000 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org.ua> | 2008-12-26 10:18:53 +0000 |
commit | 6106d7f2c61617185a1150a0cc5ba66e3096ec77 (patch) | |
tree | f4f6da58428fee44fc79c1a876d0cbd7b2e901d5 /doc/mailfromd.texi | |
parent | 3faf6f97adb88ad88aea7fdffb683f737fe5b068 (diff) | |
download | mailfromd-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.texi | 101 |
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 |