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