Mercurial > emacs

comparison INSTALL @ 42213:a85200bb3831

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Remove text that describes Leim as a separate package.
author Eli Zaretskii <eliz@gnu.org>
date Fri, 21 Dec 2001 08:56:39 +0000
parents f644b704f8b8
children 1af7ce62a225
comparison
equal deleted inserted replaced
42212:0a5829018719 42213:a85200bb3831
1 GNU Emacs Installation Guide 1 GNU Emacs Installation Guide
2 Copyright (c) 1992, 1994, 1996, 1997, 2000 Free software Foundation, Inc. 2 Copyright (c) 1992, 1994, 1996, 1997, 2000, 2001 Free software Foundation, Inc.
3 See the end of the file for copying permissions. 3 See the end of the file for copying permissions.
4 4
5 5
6 BASIC INSTALLATION 6 BASIC INSTALLATION
7 7
19 doesn't work, you might need to use various non-default options, and 19 doesn't work, you might need to use various non-default options, and
20 maybe perform some of the steps manually. The more detailed 20 maybe perform some of the steps manually. The more detailed
21 description in the rest of the sections of this guide will help you do 21 description in the rest of the sections of this guide will help you do
22 that, so please refer to them if the simple procedure does not work. 22 that, so please refer to them if the simple procedure does not work.
23 23
24 1. If you want to be able to input international characters which 24 1. Make sure your system has at least 120 MB of free disk space.
25 your keyboard doesn't support directly (i.e. you cannot type 25
26 them at the shell prompt), download the leim-M.N.tar.gz 26 2a. `cd' to the directory where you unpacked Emacs and invoke the
27 distribution and unpack it into the same directory where you have
28 unpacked the main Emacs distribution. See ADDITIONAL
29 DISTRIBUTION FILES, below, for more about this.
30
31 2. Make sure your system has at least 120 MB of free disk space.
32
33 3a. `cd' to the directory where you unpacked Emacs and invoke the
34 `configure' script: 27 `configure' script:
35 28
36 ./configure 29 ./configure
37 30
38 3b. Alternatively, create a separate directory, outside the source 31 2b. Alternatively, create a separate directory, outside the source
39 directory, where you want to build Emacs, and invoke `configure' 32 directory, where you want to build Emacs, and invoke `configure'
40 from there: 33 from there:
41 34
42 SOURCE-DIR/configure 35 SOURCE-DIR/configure
43 36
44 where SOURCE-DIR is the top-level Emacs source directory. This 37 where SOURCE-DIR is the top-level Emacs source directory. This
45 may not work unless you use GNU make. 38 may not work unless you use GNU make.
46 39
47 4. When `configure' finishes, it prints several lines of details 40 3. When `configure' finishes, it prints several lines of details
48 about the system configuration. Read those details carefully 41 about the system configuration. Read those details carefully
49 looking for anything suspicious, such as wrong CPU and operating 42 looking for anything suspicious, such as wrong CPU and operating
50 system names, wrong places for headers or libraries, missing 43 system names, wrong places for headers or libraries, missing
51 libraries that you know are installed on your system, etc. 44 libraries that you know are installed on your system, etc.
52 45
60 "Image support libraries", below. 53 "Image support libraries", below.
61 54
62 If the details printed by `configure' don't make any sense to 55 If the details printed by `configure' don't make any sense to
63 you, assume that `configure' did its job and proceed. 56 you, assume that `configure' did its job and proceed.
64 57
65 5. If you need to run the `configure' script more than once (e.g., 58 4. If you need to run the `configure' script more than once (e.g.,
66 with some non-default options), always clean the source 59 with some non-default options), always clean the source
67 directories before running `configure' again: 60 directories before running `configure' again:
68 61
69 make distclean 62 make distclean
70 ./configure 63 ./configure
71 64
72 6. Invoke the `make' program: 65 5. Invoke the `make' program:
73 66
74 make 67 make
75 68
76 7. If `make' succeeds, it will build an executable program `emacs' 69 6. If `make' succeeds, it will build an executable program `emacs'
77 in the `src' directory. You can try this program, to make sure 70 in the `src' directory. You can try this program, to make sure
78 it works: 71 it works:
79 72
80 src/emacs -q 73 src/emacs -q
81 74
82 8. Assuming that the program `src/emacs' starts and displays its 75 7. Assuming that the program `src/emacs' starts and displays its
83 opening screen, you can install the program and its auxiliary 76 opening screen, you can install the program and its auxiliary
84 files into their installation directories: 77 files into their installation directories:
85 78
86 make install 79 make install
87 80
95 and installed Lisp source (.el) files which have corresponding .elc 88 and installed Lisp source (.el) files which have corresponding .elc
96 versions. 89 versions.
97 90
98 91
99 ADDITIONAL DISTRIBUTION FILES 92 ADDITIONAL DISTRIBUTION FILES
100
101 * leim-M.N.tar.gz
102
103 The Emacs Lisp code for input methods for various international
104 character scripts allows you to input characters in scripts which are
105 not directly supported by your keyboard. It is distributed in a
106 separate tar file because it amounts to a significant fraction of the
107 size of the distribution. This tar file is called leim-M.N.tar.gz,
108 with the same version number as Emacs, and it unpacks into the
109 directory emacs-M.N/leim.
110
111 You should unpack leim-M.N.tar.gz into the same directory where you
112 have previously unpacked the main Emacs distribution. It fills in the
113 contents of one subdirectory, which is present in the main Emacs
114 distribution only in dummy form.
115
116 Once you have unpacked the Leim tar file into the Emacs source tree,
117 building and installing Emacs automatically installs the input method
118 support as well. If you have built Emacs without unpacking Leim
119 first, just unpack Leim, build Emacs again, and install it again.
120 93
121 * intlfonts-VERSION.tar.gz 94 * intlfonts-VERSION.tar.gz
122 95
123 The intlfonts distribution contains X11 fonts that Emacs needs in 96 The intlfonts distribution contains X11 fonts that Emacs needs in
124 order to display international characters. If you see a non-ASCII 97 order to display international characters. If you see a non-ASCII
205 least 2.5 MB and can reach 80 MB or more. If the swapping space is 178 least 2.5 MB and can reach 80 MB or more. If the swapping space is
206 insufficient, you will get an error in the command `temacs -batch -l 179 insufficient, you will get an error in the command `temacs -batch -l
207 loadup dump', found in `./src/Makefile.in', or possibly when 180 loadup dump', found in `./src/Makefile.in', or possibly when
208 running the final dumped Emacs. 181 running the final dumped Emacs.
209 182
210 Building Emacs requires about 95 MB of disk space (including the Emacs 183 Building Emacs requires about 130 MB of disk space (including the
211 sources), or 130 MB if Leim is used. Once installed, Emacs occupies 184 Emacs sources) Once installed, Emacs occupies about 70 MB in the file
212 about 60 MB (70 MB with Leim) in the file system where it is 185 system where it is installed; this includes the executable files, Lisp
213 installed; this includes the executable files, Lisp libraries, 186 libraries, miscellaneous data files, and on-line documentation. If
214 miscellaneous data files, and on-line documentation. If the building 187 the building and installation take place in different directories,
215 and installation take place in different directories, then the 188 then the installation procedure momentarily requires 130+70 MB.
216 installation procedure momentarily requires 95+60 MB (130+70 MB).
217 189
218 2) Consult `./etc/MACHINES' to see what configuration name you should 190 2) Consult `./etc/MACHINES' to see what configuration name you should
219 give to the `configure' program. That file offers hints for 191 give to the `configure' program. That file offers hints for
220 getting around some possible installation problems. The file lists 192 getting around some possible installation problems. The file lists
221 many different configurations, but only the part for your machine and 193 many different configurations, but only the part for your machine and
803 djtar -x emacs.tgz 775 djtar -x emacs.tgz
804 776
805 (This assumes that the Emacs distribution is called `emacs.tgz' on 777 (This assumes that the Emacs distribution is called `emacs.tgz' on
806 your system.) 778 your system.)
807 779
808 If you need to type international characters, you will need to unpack
809 the Leim distribution (see the description near the beginning of this
810 file). You unpack it from the same directory where you unpacked
811 Emacs. To unpack Leim with djtar, assuming the Leim distribution is
812 called `leim.tgz', type this command:
813
814 djtar -x leim.tgz
815
816 If you want to print international characters, install the intlfonts 780 If you want to print international characters, install the intlfonts
817 distribution. For this, create a directory called `fonts' under the 781 distribution. For this, create a directory called `fonts' under the
818 Emacs top-level directory (usually called `emacs-XX.YY') created by 782 Emacs top-level directory (usually called `emacs-XX.YY') created by
819 unpacking emacs.tgz, chdir into the directory emacs-XX.YY/fonts, and 783 unpacking emacs.tgz, chdir into the directory emacs-XX.YY/fonts, and
820 type this: 784 type this:
862 sibling directory called bin. For example, if you build in directory 826 sibling directory called bin. For example, if you build in directory
863 /emacs, installing moves the executables from /emacs/src and 827 /emacs, installing moves the executables from /emacs/src and
864 /emacs/lib-src to the directory /emacs/bin, so you can then delete the 828 /emacs/lib-src to the directory /emacs/bin, so you can then delete the
865 subdirectories /emacs/src and /emacs/lib-src if you wish. The only 829 subdirectories /emacs/src and /emacs/lib-src if you wish. The only
866 subdirectories you need to keep are bin, lisp, etc and info. (If you 830 subdirectories you need to keep are bin, lisp, etc and info. (If you
867 installed Leim, keep the leim subdirectory, and if you installed 831 installed intlfonts, keep the fonts directory and all its
868 intlfonts, keep the fonts directory and all its subdirectories as well.) 832 subdirectories as well.) The bin subdirectory should be added to your
869 The bin subdirectory should be added to your PATH. The msdos 833 PATH. The msdos subdirectory includes a PIF and an icon file for
870 subdirectory includes a PIF and an icon file for Emacs which you might 834 Emacs which you might find useful if you run Emacs under MS Windows.
871 find useful if you run Emacs under MS Windows.
872 835
873 Emacs on MSDOS finds the lisp, etc and info directories by looking in 836 Emacs on MSDOS finds the lisp, etc and info directories by looking in
874 ../lisp, ../etc and ../info, starting from the directory where the 837 ../lisp, ../etc and ../info, starting from the directory where the
875 Emacs executable was run from. You can override this by setting the 838 Emacs executable was run from. You can override this by setting the
876 environment variables EMACSDATA (for the location of `etc' directory), 839 environment variables EMACSDATA (for the location of `etc' directory),