Doc fix.
[bpt/emacs.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index f35791e..bec3af5 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -76,19 +76,30 @@ that file `dir' in this directory contains an entry like this:
 * Image support libraries
 
 Emacs needs optional libraries to be able to display images (with the
-exception of PBM images whose support is built-in).  Here's the list
-of these optional libraries, and the URLs where they can be found:
+exception of PBM and XBM images whose support is built-in).  On some
+systems these may already be present or available as additional
+packages, particularly on GNU/Linux.  (In some cases older versions
+won't work because some routines are missing, and configure should
+avoid such old versions.)
+
+If necessary, you can build them from source.  None are vital for
+running Emacs.  Here's the list of these optional libraries, and the
+URLs where they can be found:
 
   . libxpm for XPM:   ftp://ftp.x.org/contrib/libraries/
   . libpng for PNG:   ftp://www.libpng.org/pub/png/
-  . Zlib (for PNG):   http://www.info-zip.org/pub/infozip/zlib/
+  . libz (for PNG):   http://www.info-zip.org/pub/infozip/zlib/
   . libjpeg for JPEG: ftp://ftp.uu.net/graphics/jpeg/
   . libtiff for TIFF: http://www.libtiff.org/
   . libungif for GIF: 
       http://prtr-13.ucsc.edu/~badger/software/libungif/index.shtml
 
-Emacs needs to be configured with the appropriate --with-LIB option,
-to be built with these libraries.  See below for more details.
+[libungif-4.1.0 can crash Emacs with uncompressed GIFs -- use
+libungif-4.1.0b1.]
+
+Emacs will configure itself to build with these libraries if configure
+finds them on your system unless you supply the appropriate
+--without-LIB option.  See below for more details.
 
 
 BUILDING AND INSTALLATION:
@@ -155,27 +166,27 @@ compile Emacs using GCC.  If you don't want to use GCC, specify
 `--with-gcc=no'.  If you omit this option, `configure' will search
 for GCC in your path, and use it if present.
 
-If you want the Emacs mail reader RMAIL to read mail from a POP
-server, you must specify `--with-pop'.  This provides support for the
-POP3 protocol; older versions are not supported.  For
-Kerberos-authenticated POP add `--with-kerberos', for Hesiod support
-add `--with-hesiod'.  These options enable Emacs to use POP; whether
-Emacs uses POP is controlled by individual users--see the Rmail
-chapter of the Emacs manual.
+The Emacs mail reader RMAIL is configured to be able to read mail from
+a POP3 server by default.  Versions of the POP protocol older than
+POP3 are not supported.  For Kerberos-authenticated POP add
+`--with-kerberos', for Hesiod support add `--with-hesiod'.  While POP3
+is always enabled, whether Emacs actually uses POP is controlled by
+individual users--see the Rmail chapter of the Emacs manual.
 
-To get Emacs with image support, configure with one or more of these
-options:
+For image support you may have to download, build, and install the
+appropriate image support libraries for image types other than XBM and
+PBM, see the list of URLs in "ADDITIONAL DISTRIBUTION FILES" above.
+(Note that PNG support requires libz in addition to libpng.)
 
-  --with-xpm        for XPM image support
-  --with-jpeg       for JPEG image support
-  --with-tiff       for TIFF image support
-  --with-gif        for GIF image support
-  --with-png        for PNG image support
+To disable individual types of image support in Emacs for some reason,
+even though configure finds the libraries, you can configure with one
+or more of these options:
 
-You will have to download, build, and install the appropriate image
-support libraries, see the list of URLs in "ADDITIONAL DISTRIBUTION
-FILES" above.  (Note that configuring --with-png requires Zlib in
-addition to libpng.)
+  --without-xpm        for XPM image support
+  --without-jpeg       for JPEG image support
+  --without-tiff       for TIFF image support
+  --without-gif        for GIF image support
+  --without-png        for PNG image support
 
 The `--prefix=PREFIXDIR' option specifies where the installation process
 should put emacs and its data files.  This defaults to `/usr/local'.
@@ -672,6 +683,16 @@ Emacs, chdir to that directory and type these commands:
     config msdos
     make install
 
+Running "config msdos" checks for several programs that are required
+to configure and build Emacs; if one of those programs is not found,
+CONFIG.BAT stops and prints an error message.  If you have DJGPP
+version 2.0 or 2.01, it will complain about a program called
+DJECHO.EXE.  These old versions of DJGPP shipped that program under
+the name ECHO.EXE, so you can simply copy ECHO.EXE to DJECHO.EXE and
+rerun CONFIG.BAT.  If you have neither ECHO.EXE nor DJECHO.EXE, you
+should be able to find them in your djdevNNN.zip archive (where NNN is
+the DJGPP version number).
+
 To install the international fonts, chdir to the intlfonts-X.Y
 directory created when you unpacked the intlfonts distribution (X.Y is
 the version number of the fonts' distribution), and type the following