Add a pointer to README.svn.

Replace GRAVE character by APOSTROPHE.
Mention OpenSSL and recommend building it as shared library.
Remove --with-included-gettext pointer. We don't ship gettext.

svn path=/trunk/; revision=4328

1 files changed, 28 insertions, 12 deletions

diff --git a/INSTALL b/INSTALL
index 96f869ad..3a623b9a 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,6 +1,9 @@
 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.
+
 If you have installed binaries (e.g. from a Linux RPM or DPKG, Solaris
 package or FreeBSD port), you can skip to step 5.
 
@@ -10,6 +13,8 @@ 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
@@ -24,23 +29,34 @@ 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.2 OpenSSL
+
+If you are installing OpenSSL yourself, it is recommended that you build
+shared OpenSSL libraries, it works better and updating OpenSSL does not
+then require you to reinstall all applications that use OpenSSL.
+
+Try after unpacking OpenSSL:
+
+	./config shared && make && make test && make install
+
+1.3 IPv6
+
 Building in IPv6 support *requires* an up-to-date operating system.
 Recent Linux versions with glibc 2.1.1 or newer, FreeBSD, Solaris should
 be fine.
 
 If you have trouble with intl or gettext functions, try using the
-configure option `--with-included-gettext'.
+configure option '--with-included-gettext'.
 
 
 2. CONFIGURE
 
+2.1 Basic options
+
 Installing fetchmail is easy.  From within this directory, type:
 
 	./configure
 
-(If your gettext is old, you may need to include the
---with-included-gettext option).
-
 The autoconfiguration script will spend a bit of time figuring out the
 specifics of your system.  If you want to specify a particular compiler
 (e.g. you have gcc but want to compile with cc), set the environment
@@ -48,24 +64,24 @@ variable CC before you run configure.
 
 The configure script accepts certain standard configuration options.
 These include --prefix, --exec-prefix, --bindir, --infodir, --mandir,
-and --srcdir.  Do `configure --help' for more.
+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
+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'.
+can compile it in with 'configure --enable-RPA'.
 
 Support for Microsoft's NTLM authentication method is also available
 but also not included in the standard build.  You can compile it in
-with `configure --enable-NTLM'.
+with 'configure --enable-NTLM'.
 
 Support for authentication using RFC1731 GSSAPI is available
 but also not included by default.  You can compile it in with
-`configure --with-gssapi', which looks for GSSAPI support in standard
+'configure --with-gssapi', which looks for GSSAPI support in standard
 locations (/usr, /usr/local).  If you set --with-GSSAPI=DIR
 you can direct the build to look for GSSAPI support under DIR.
 
@@ -90,8 +106,8 @@ MDA use. If you wish to proceed nonetheless, do one of:
 A disadvantage of using procmail is that local alias expansion
 according to /etc/aliases won't get done if we fall back to it.
 
-Advanced configuration:
------------------------
+2.2 Advanced options
+
 Specifying --with-kerberos=DIR or --with-kerberos5=DIR will tell the
 fetchmail build process to look in DIR for Kerberos support.
 Configure normally looks in /usr/kerberos and /usr/athena; if you
@@ -111,7 +127,7 @@ POP3, IMAP, and ETRN (with configure arguments of --disable-POP3,
 --disable-IMAP, and --disable-ETRN respectively).
 
 
-3. MAKE
+3. BUILD
 
 Run