INSTALL Instructions for fetchmail
==================================
-If you are installing from the subversion repository, see README.svn for
-further instructions on how to set up the checked out repository.
+Building from Git repository: see README.git
+
+Packagers and port/emerge maintainers: see README.packaging.
+
If you have installed binaries (e.g. from a Linux RPM or DPKG, Solaris
-package or FreeBSD port), you can skip to step 5.
+package or FreeBSD port), you can skip to step 5 below.
+---------------------------------------------------------------------
The Frequently Asked Questions list, included as the file FAQ in this
-distributions, answers the most common questions about configuring and
+distribution, answers the most common questions about configuring and
running fetchmail.
+---------------------------------------------------------------------
-1. USEFUL THINGS TO INSTALL FIRST
-
-1.1 OTP/OPIE
-
-If you want support for RFC1938-compliant one-time passwords, you'll
-need to install Craig Metz's OPIE libraries first and *make sure
-they're on the normal library path* where configure will find them. Then
-configure with --enable-OPIE, and fetchmail build process will detect
-them and compile appropriately.
+NOTE This is an alpha version that has not been thoroughly tested!
+=====
-Note: there is no point in doing this unless your server is
-OTP-enabled. To test this, telnet to the server port and give it
-a valid USER id. If the OK response includes the string "otp-",
-you should install OPIE. You need version 2.32 or better.
-The OPIE library sources are available at http://www.inner.net/pub/opie/
-You can also find OPIE and IPV6-capable servers there.
+1. PREPARATIONS: USEFUL THINGS TO INSTALL FIRST
-1.2 OpenSSL
+1.1 OpenSSL
If you are installing OpenSSL yourself, it is recommended that you build
shared OpenSSL libraries, it works better and updating OpenSSL does not
./config shared && make && make test && make install
-1.3 gettext (internationalization)
+1.2 gettext (internationalization)
Internationalization of fetchmail requires GNU gettext (libintl and
libiconv). Fetchmail, as of version 6.3.0, no longer ships its own
-libintl copy.
+libintl copy. Note that some systems include gettext in their libc.
+
+1.3 OTP/OPIE
+
+If you want support for RFC1938-compliant one-time passwords, you'll
+need to install Craig Metz's OPIE libraries first and *make sure
+they're on the normal library path* where configure will find them. Then
+configure with --enable-OPIE, and fetchmail build process will detect
+them and compile appropriately.
+
+Note: there is no point in doing this unless your server is
+OTP-enabled. To test this, telnet to the server port and give it
+a valid USER id. If the OK response includes the string "otp-",
+you should install OPIE. You need version 2.32 or better.
+
+The OPIE library sources are available at http://www.inner.net/pub/opie/
+You can also find OPIE and IPV6-capable servers there.
1.4 IPv6
These include --prefix, --exec-prefix, --bindir, --infodir, --mandir,
and --srcdir. Do 'configure --help' for more.
-POP2 support is no longer compiled in by default, as POP2 is way obsolete
-and there don't seem to be any live servers for it anymore. You can
-configure it back in if you want with 'configure --enable-POP2', but
-leaving it out cuts the executable's size slightly.
-
Support for CompuServe's RPA authentication method (rather similar to
APOP) is available but also not included in the standard build. You
can compile it in with 'configure --enable-RPA'.