X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/4208da83badb46cf64ade7a331d57cf14612bd2c..bd9b2b20ef76bf76087f73c1b7977c908d920829:/INSTALL
diff --git a/INSTALL b/INSTALL
index fa09f705b4..8b20659629 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,5 +1,5 @@
GNU Emacs Installation Guide
-Copyright (c) 1992, 1994, 1996, 1997, 2000, 2001 Free software Foundation, Inc.
+Copyright (c) 1992, 94, 96, 97, 2000, 01, 02 Free software Foundation, Inc.
See the end of the file for copying permissions.
@@ -59,7 +59,7 @@ that, so please refer to them if the simple procedure does not work.
with some non-default options), always clean the source
directories before running `configure' again:
- make distclean
+ make distclean
./configure
5. Invoke the `make' program:
@@ -93,13 +93,13 @@ ADDITIONAL DISTRIBUTION FILES
* intlfonts-VERSION.tar.gz
-The intlfonts distribution contains X11 fonts that Emacs needs in
-order to display international characters. If you see a non-ASCII
-character appear as a hollow box, that means you don't have a font for
-it. You might find a font in the intlfonts distribution. If you do
-have a font for a non-ASCII character, but some characters don't look
-right, or appear improperly aligned, a font from the intlfonts
-distribution might look better.
+The intlfonts distribution contains X11 fonts in various encodings
+that Emacs can use to display international characters. If you see a
+non-ASCII character appear as a hollow box, that means you don't have
+a font for it. You might find one in the intlfonts distribution. If
+you do have a font for a non-ASCII character, but some characters
+don't look right, or appear improperly aligned, a font from the
+intlfonts distribution might look better.
The fonts in the intlfonts distribution are also used by the ps-print
package for printing international characters. The file
@@ -127,10 +127,10 @@ colored icons in the toolbar if XPM support is not compiled in.
Here's the list of these optional libraries, and the URLs where they
can be found:
- . libXaw3d for fancy 3D-style
+ . libXaw3d for fancy 3D-style
scroll bars: ftp://ftp.x.org/contrib/widgets/Xaw3d/
. libxpm for XPM: ftp://ftp.x.org/contrib/libraries/
- Get version 3.4k or later, which lets Emacs
+ Get version 3.4k or later, which lets Emacs
use its own color allocation functions.
. libpng for PNG: ftp://www.libpng.org/pub/png/
. libz (for PNG): http://www.info-zip.org/pub/infozip/zlib/
@@ -138,7 +138,7 @@ can be found:
Get version 6b -- 6a is reported to fail in
Emacs.
. libtiff for TIFF: http://www.libtiff.org/
- . libungif for GIF:
+ . libungif for GIF:
http://prtr-13.ucsc.edu/~badger/software/libungif/index.shtml
Ensure you get version 4.1.0b1 or higher of libungif -- a bug in
4.1.0 can crash Emacs.
@@ -152,23 +152,44 @@ configure should avoid such old versions. If that happens, use the
* Extra fonts
+At first, Emacs does not include fonts and does not install them. You
+must do this yourself.
+
To take proper advantage of Emacs 21's mule-unicode charsets, you need
-a Unicode font. For information on Unicode fonts for X, see
-,
- and
+a suitable font. For `Unicode' (ISO 10646) fonts for X, see
+ (packaged in Debian),
+ (packaged in Debian). (In
+recent Debian versions, there is an extensive `misc-fixed' iso10646-1
+in the default X installation.) Perhaps also see
.
+
has basic fonts for Emacs's
ISO-8859 charsets.
XFree86 release 4 (from and mirrors)
contains font support for most, if not all, of the charsets that Emacs
-supports. The font files should be usable separately with older X
-releases.
+currently supports, including iso10646-1 encoded fonts for use with
+the mule-unicode charsets. The font files should also be usable with
+older X releases. Note that XFree 4 contains many iso10646-1 fonts
+with minimal character repertoires, which can cause problems -- see
+etc/PROBLEMS.
BDF fonts etl-unicode.tar.gz used by ps-print and ps-mule to print
Unicode characters are available from
and .
+* GNU/Linux development packages
+
+Many GNU/Linux systems do not come with development packages by
+default; they just include the files that you need to run Emacs, but
+not those you need to compile it. For example, to compile Emacs with
+X11 support, you may need to install the special `X11 development'
+package. For example, in April 2003, the package names to install
+were `XFree86-devel' and `Xaw3d-devel' on RedHat. On Debian, the
+packages necessary to build the installed version should be
+sufficient; they can be installed using `apt-get build-dep emacs21' in
+Debian 3 and above.
+
DETAILED BUILDING AND INSTALLATION:
@@ -183,7 +204,7 @@ least 2.8 MB and can reach 100 MB or more. If the swapping space is
insufficient, you will get an error in the command `temacs -batch -l
loadup dump', found in `./src/Makefile.in', or possibly when
running the final dumped Emacs.
-
+
Building Emacs requires about 140 MB of disk space (including the
Emacs sources) Once installed, Emacs occupies about 77 MB in the file
system where it is installed; this includes the executable files, Lisp
@@ -227,7 +248,7 @@ accept a list of directories, separated with colons.
To get more attractive menus, you can specify an X toolkit when you
configure Emacs; use the option `--with-x-toolkit=TOOLKIT', where
-TOOLKIT is `athena' or `motif' (`yes' and `lucid' are synonyms for
+TOOLKIT is `athena', `motif' or `gtk' (`yes' and `lucid' are synonyms for
`athena'). On some systems, it does not work to use a toolkit with
shared libraries. A free implementation of Motif, called LessTif, is
available ftom . Compiling with LessTif or
@@ -237,6 +258,11 @@ bars, even without LessTif/Motif, if you have the Xaw3d library
installed (see "Image support libraries" above for Xaw3d
availability).
+If `--with-x-toolkit=gtk' is specified, you can tell configure where
+to search for GTK by specifying `--with-pkg-config-prog=PATH' where
+PATH is the pathname to pkg-config. Note that GTK version 2.0 or
+newer is required for Emacs.
+
The `--with-gcc' option specifies that the build process should
compile Emacs using GCC. If you don't want to use GCC, specify
`--with-gcc=no'. If you omit this option, `configure' will search
@@ -534,7 +560,7 @@ Here is a complete list of the variables you may want to set.
We create the following subdirectories under `libexecdir':
- `emacs/VERSION/CONFIGURATION-NAME', containing executable
programs used by Emacs that users are not expected to run
- themselves.
+ themselves.
`VERSION' is the number of the Emacs version you are installing,
and `CONFIGURATION-NAME' is the argument you gave to the
`configure' program to identify the architecture and operating