mfmod_pcre README.
See the end of file for copying conditions.

* Overview

This package is a loadable module for mailfromd that adds Perl-
compatible regular expressions to the mail filtering language (MFL).

See the accompanying documentation for details.

* Bug reports

Send bug reports and suggestions to <gray@gnu.org>.  Be sure to
mention "mfmod_pcre" somewhere in the Subject line.

* Compiling

To compile and use mfmod_pcre, you will need mailfromd 8.14.91 or
later and pcre2 10.35 or later.  The usual build procedure applies:

** ./configure

This will configure the package.  By default, the module will be
installed to the library directory used by mailfromd installed on your
machine.  To install it to another directory, use the --with-mfmoddir
coniguration option (you will have to change the runtime configuration
of mailfromd in order for it to be able to load the module, then).

If mailfromd binary is installed to a directory not listed in the
value of the $PATH environment variable, you are advised to add this
directory to the $PATH used by configure, like that:

  ./configure PATH=/usr/local/sbin:$PATH

This makes sure configure and, if you choose to run it, make check
will be able to find the binary.

For a detailed discussion of generic configure options, refer to:
https://www.gnu.org/savannah-checkouts/gnu/autoconf/manual/autoconf-2.71/html_node/Running-configure-Scripts.html

**  make

This will build the module.

** make check

Optional step.  This will run the testsuite.  It relies on the
mailfromd binary being locatable using $PATH (see the ./configure
step), so make sure to define it properly.

** make install

Installs the package.

* Building from git sources

If you have cloned the package from git, you will need the following:

** A C compiler
** make
** GNU autoconf
** GNU automake
** GNU libtool
** Mailfromd 8.14.91 or later

First, bootstrap the package:

  autoreconf -f -i -s

If it cannot find the AC_MFMOD, use the -I option to point it to the
directory where mfmod.m4 file is installed, e.g.:

  autoreconf -f -i -s -I /usr/local/share/aclocal/

Once done, proceed as described above.

* Links

** This package <https://www.gnu.org.ua/software/mfmod_pcre/>
** Project page <https://puszcza.gnu.org.ua/projects/mfmod_pcre/>
** Downloads    <https://download.gnu.org.ua/release/mfmod_pcre>
** Mailfromd	<https://www.gnu.org.ua/software/mailfromd/>


* Copyright information:

Copyright (C) 2022-2023 Sergey Poznyakoff

   Permission is granted to anyone to make or distribute verbatim copies
   of this document as received, in any medium, provided that the
   copyright notice and this permission notice are preserved,
   thus giving the recipient permission to redistribute in turn.

   Permission is granted to distribute modified versions
   of this document, or of portions of it,
   under the above conditions, provided also that they
   carry prominent notices stating who last changed them.


Local Variables:
mode: outline
paragraph-separate: "[ 	]*$"
version-control: never
End:
