+ 2b. Alternatively, create a separate directory, outside the source
+ directory, where you want to build Emacs, and invoke `configure'
+ from there:
+
+ SOURCE-DIR/configure
+
+ where SOURCE-DIR is the top-level Emacs source directory. This
+ may not work unless you use GNU make.
+
+ 3. When `configure' finishes, it prints several lines of details
+ about the system configuration. Read those details carefully
+ looking for anything suspicious, such as wrong CPU and operating
+ system names, wrong places for headers or libraries, missing
+ libraries that you know are installed on your system, etc.
+
+ If you find anything wrong, you will have to pass to `configure'
+ explicit machine configuration name, and one or more options
+ which tell it where to find various headers and libraries; refer
+ to DETAILED BUILDING AND INSTALLATION section below.
+
+ If `configure' didn't find some image support libraries, such as
+ Xpm, jpeg, etc., and you want to use them refer to the subsection
+ "Image support libraries", below.
+
+ If the details printed by `configure' don't make any sense to
+ you, assume that `configure' did its job and proceed.
+
+ 4. If you need to run the `configure' script more than once (e.g.,
+ with some non-default options), always clean the source
+ directories before running `configure' again:
+
+ make distclean
+ ./configure
+
+ 5. Invoke the `make' program:
+
+ make
+
+ 6. If `make' succeeds, it will build an executable program `emacs'
+ in the `src' directory. You can try this program, to make sure
+ it works:
+
+ src/emacs -q
+
+ 7. Assuming that the program `src/emacs' starts and displays its
+ opening screen, you can install the program and its auxiliary
+ files into their installation directories:
+
+ make install
+
+ You are now ready to use Emacs. If you wish to conserve disk space,
+ you may remove the program binaries and object files from the
+ directory where you built Emacs:
+
+ make clean
+
+ You can also save some space by compressing (with `gzip') Info files
+ and installed Lisp source (.el) files which have corresponding .elc
+ versions.
+
+
+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 fonts in the intlfonts distribution are also used by the ps-print
+package for printing international characters. The file
+lisp/ps-mule.el defines the *.bdf font files required for printing
+each character set.
+
+The intlfonts distribution contains its own installation instructions,
+in the intlfonts/README file.
+
+* Image support libraries
+
+Emacs needs optional libraries to be able to display images (with the
+exception of PBM and XBM images whose support is built-in).
+
+On some systems, particularly on GNU/Linux, these libraries may
+already be present or available as additional packages. Note that if
+there is a separate `dev' or `devel' package, for use at compilation
+time rather than run time, you will need that as well as the
+corresponding run time package; typically the dev package will
+contain header files and a library archive. Otherwise, you can
+download and build libraries from sources. None of them are vital for
+running Emacs; however, note that Emacs will not be able to use
+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
+ 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
+ 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/
+ . libjpeg for JPEG: ftp://ftp.uu.net/graphics/jpeg/
+ Get version 6b -- 6a is reported to fail in
+ Emacs.
+ . libtiff for TIFF: http://www.libtiff.org/
+ . 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.
+
+Emacs will configure itself to build with these libraries if the
+`configure' script finds them on your system, unless you supply the
+appropriate --without-LIB option. In some cases, older versions of
+these libraries won't work because some routines are missing, and
+configure should avoid such old versions. If that happens, use the
+--without-LIB options to `configure'. See below for more details.
+
+* Extra fonts
+
+To take proper advantage of Emacs 21's mule-unicode charsets, you need
+a Unicode font. For information on Unicode fonts for X, see
+<URL:http://czyborra.com/unifont/>,
+<URL:http://openlab.ring.gr.jp/efont/> and
+<URL:http://www.cl.cam.ac.uk/%7Emgk25/ucs-fonts.html>.
+<URL:http://czyborra.com/charsets/> has basic fonts for Emacs's
+ISO-8859 charsets.
+
+XFree86 release 4 (from <URL:ftp://ftp.xfree86.org/> 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.
+
+BDF fonts etl-unicode.tar.gz used by ps-print and ps-mule to print
+Unicode characters are available from <URL:ftp://ftp.x.org/contrib/fonts/>
+and <URL:ftp://ftp.xfree86.org/pub/X.Org/contrib/fonts/>.
+
+
+The new Indian implementation uses the ISFOC standard fonts. We use
+CDAC ISFOC fonts to display the Devanagari script in Emacs. They are
+copyrighted, but we received permission to use them in Emacs from the
+font developers. These fonts can be obtained from the internet, or
+may be found in C-DAC products (including downloadable ones). For
+examle, you can search the CDAC Devanagari font `dvsr0ntt.ttf' by
+using some search engines and they will guide you to appropriate URLs
+to obtain them.
+
+After you've downloaded the fonts, then run the following Makefile
+to create the appropriate BDF/PCF fonts. (You will need `ttf2bdf',
+equipped with freetype 1, to create BDF file.)
+
+TTFS= asdr0ntt.ttf:Assamese\
+ bndr0ntt.ttf:Bengali\
+ dvsr0ntt.ttf:Devanagari\
+ gjav0ntt.ttf:Gujarati\
+ knum0ntt.ttf:Kannada\
+ mlkr0ntt.ttf:Malayalam\
+ orsr0ntt.ttf:Oriya\
+ pnam0ntt.ttf:Punjabi\
+ sdsr0ntt.ttf:Sanskrit\
+ tlhm0ntt.ttf:Telugu\
+ tmvl0ntt.ttf:Tamil
+
+all:
+ for f in ${TTFS}; do \
+ ttf=`echo $$f | sed 's/:.*$$//'`; \
+ reg=`echo $$f | sed 's/[^:]*://'`; \
+ base=`basename $$ttf .ttf`; \
+ echo Converting "$$ttf to $$base-XX.bdf/pcf with registry $$reg"; \
+ for i in 16 24; do \
+ ttf2bdf -p $${i} -r 100 -l 0_255 $$ttf > temp; \
+ sed "/^FONT /s/ISO10646-1/$$reg-CDAC/" <temp >$$base-$$i.bdf; \
+ bdftopcf $$base-$$i.bdf > $$base-$$i.pcf; \
+ done; \
+ done
+ rm -f temp
+
+clean:
+ rm -f *.pcf *.bdf
+
+
+DETAILED BUILDING AND INSTALLATION:
+
+(This is for a Unix or Unix-like system. For MS-DOS and Windows 3.X,
+see below; search for MSDOG. For Windows 9X, Windows ME, Windows NT,
+and Windows 2000, see the file nt/INSTALL. For the Mac, see the file
+mac/INSTALL.)