1 |
GNU Emacs Installation Guide |
GNU Emacs Installation Guide |
2 |
Copyright (c) 1992, 1994, 1996, 1997, 2000 Free software Foundation, Inc. |
Copyright (c) 1992, 1994, 1996, 1997, 2000, 2001 Free software Foundation, Inc. |
3 |
See the end of the file for copying permissions. |
See the end of the file for copying permissions. |
4 |
|
|
5 |
|
|
21 |
description in the rest of the sections of this guide will help you do |
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. |
that, so please refer to them if the simple procedure does not work. |
23 |
|
|
24 |
1. If you want to be able to input international characters which |
1. Make sure your system has at least 120 MB of free disk space. |
|
your keyboard doesn't support directly (i.e. you cannot type |
|
|
them at the shell prompt), download the leim-M.N.tar.gz |
|
|
distribution and unpack it into the same directory where you have |
|
|
unpacked the main Emacs distribution. See ADDITIONAL |
|
|
DISTRIBUTION FILES, below, for more about this. |
|
25 |
|
|
26 |
2. Make sure your system has at least 120 MB of free disk space. |
2a. `cd' to the directory where you unpacked Emacs and invoke the |
|
|
|
|
3a. `cd' to the directory where you unpacked Emacs and invoke the |
|
27 |
`configure' script: |
`configure' script: |
28 |
|
|
29 |
./configure |
./configure |
30 |
|
|
31 |
3b. Alternatively, create a separate directory, outside the source |
2b. Alternatively, create a separate directory, outside the source |
32 |
directory, where you want to build Emacs, and invoke `configure' |
directory, where you want to build Emacs, and invoke `configure' |
33 |
from there: |
from there: |
34 |
|
|
37 |
where SOURCE-DIR is the top-level Emacs source directory. This |
where SOURCE-DIR is the top-level Emacs source directory. This |
38 |
may not work unless you use GNU make. |
may not work unless you use GNU make. |
39 |
|
|
40 |
4. When `configure' finishes, it prints several lines of details |
3. When `configure' finishes, it prints several lines of details |
41 |
about the system configuration. Read those details carefully |
about the system configuration. Read those details carefully |
42 |
looking for anything suspicious, such as wrong CPU and operating |
looking for anything suspicious, such as wrong CPU and operating |
43 |
system names, wrong places for headers or libraries, missing |
system names, wrong places for headers or libraries, missing |
55 |
If the details printed by `configure' don't make any sense to |
If the details printed by `configure' don't make any sense to |
56 |
you, assume that `configure' did its job and proceed. |
you, assume that `configure' did its job and proceed. |
57 |
|
|
58 |
5. If you need to run the `configure' script more than once (e.g., |
4. If you need to run the `configure' script more than once (e.g., |
59 |
with some non-default options), always clean the source |
with some non-default options), always clean the source |
60 |
directories before running `configure' again: |
directories before running `configure' again: |
61 |
|
|
62 |
make distclean |
make distclean |
63 |
./configure |
./configure |
64 |
|
|
65 |
6. Invoke the `make' program: |
5. Invoke the `make' program: |
66 |
|
|
67 |
make |
make |
68 |
|
|
69 |
7. If `make' succeeds, it will build an executable program `emacs' |
6. If `make' succeeds, it will build an executable program `emacs' |
70 |
in the `src' directory. You can try this program, to make sure |
in the `src' directory. You can try this program, to make sure |
71 |
it works: |
it works: |
72 |
|
|
73 |
src/emacs -q |
src/emacs -q |
74 |
|
|
75 |
8. Assuming that the program `src/emacs' starts and displays its |
7. Assuming that the program `src/emacs' starts and displays its |
76 |
opening screen, you can install the program and its auxiliary |
opening screen, you can install the program and its auxiliary |
77 |
files into their installation directories: |
files into their installation directories: |
78 |
|
|
91 |
|
|
92 |
ADDITIONAL DISTRIBUTION FILES |
ADDITIONAL DISTRIBUTION FILES |
93 |
|
|
|
* leim-M.N.tar.gz |
|
|
|
|
|
The Emacs Lisp code for input methods for various international |
|
|
character scripts allows you to input characters in scripts which are |
|
|
not directly supported by your keyboard. It is distributed in a |
|
|
separate tar file because it amounts to a significant fraction of the |
|
|
size of the distribution. This tar file is called leim-M.N.tar.gz, |
|
|
with the same version number as Emacs, and it unpacks into the |
|
|
directory emacs-M.N/leim. |
|
|
|
|
|
You should unpack leim-M.N.tar.gz into the same directory where you |
|
|
have previously unpacked the main Emacs distribution. It fills in the |
|
|
contents of one subdirectory, which is present in the main Emacs |
|
|
distribution only in dummy form. |
|
|
|
|
|
Once you have unpacked the Leim tar file into the Emacs source tree, |
|
|
building and installing Emacs automatically installs the input method |
|
|
support as well. If you have built Emacs without unpacking Leim |
|
|
first, just unpack Leim, build Emacs again, and install it again. |
|
|
|
|
94 |
* intlfonts-VERSION.tar.gz |
* intlfonts-VERSION.tar.gz |
95 |
|
|
96 |
The intlfonts distribution contains X11 fonts that Emacs needs in |
The intlfonts distribution contains X11 fonts that Emacs needs in |
180 |
loadup dump', found in `./src/Makefile.in', or possibly when |
loadup dump', found in `./src/Makefile.in', or possibly when |
181 |
running the final dumped Emacs. |
running the final dumped Emacs. |
182 |
|
|
183 |
Building Emacs requires about 95 MB of disk space (including the Emacs |
Building Emacs requires about 130 MB of disk space (including the |
184 |
sources), or 130 MB if Leim is used. Once installed, Emacs occupies |
Emacs sources) Once installed, Emacs occupies about 70 MB in the file |
185 |
about 60 MB (70 MB with Leim) in the file system where it is |
system where it is installed; this includes the executable files, Lisp |
186 |
installed; this includes the executable files, Lisp libraries, |
libraries, miscellaneous data files, and on-line documentation. If |
187 |
miscellaneous data files, and on-line documentation. If the building |
the building and installation take place in different directories, |
188 |
and installation take place in different directories, then the |
then the installation procedure momentarily requires 130+70 MB. |
|
installation procedure momentarily requires 95+60 MB (130+70 MB). |
|
189 |
|
|
190 |
2) Consult `./etc/MACHINES' to see what configuration name you should |
2) Consult `./etc/MACHINES' to see what configuration name you should |
191 |
give to the `configure' program. That file offers hints for |
give to the `configure' program. That file offers hints for |
777 |
(This assumes that the Emacs distribution is called `emacs.tgz' on |
(This assumes that the Emacs distribution is called `emacs.tgz' on |
778 |
your system.) |
your system.) |
779 |
|
|
|
If you need to type international characters, you will need to unpack |
|
|
the Leim distribution (see the description near the beginning of this |
|
|
file). You unpack it from the same directory where you unpacked |
|
|
Emacs. To unpack Leim with djtar, assuming the Leim distribution is |
|
|
called `leim.tgz', type this command: |
|
|
|
|
|
djtar -x leim.tgz |
|
|
|
|
780 |
If you want to print international characters, install the intlfonts |
If you want to print international characters, install the intlfonts |
781 |
distribution. For this, create a directory called `fonts' under the |
distribution. For this, create a directory called `fonts' under the |
782 |
Emacs top-level directory (usually called `emacs-XX.YY') created by |
Emacs top-level directory (usually called `emacs-XX.YY') created by |
828 |
/emacs/lib-src to the directory /emacs/bin, so you can then delete the |
/emacs/lib-src to the directory /emacs/bin, so you can then delete the |
829 |
subdirectories /emacs/src and /emacs/lib-src if you wish. The only |
subdirectories /emacs/src and /emacs/lib-src if you wish. The only |
830 |
subdirectories you need to keep are bin, lisp, etc and info. (If you |
subdirectories you need to keep are bin, lisp, etc and info. (If you |
831 |
installed Leim, keep the leim subdirectory, and if you installed |
installed intlfonts, keep the fonts directory and all its |
832 |
intlfonts, keep the fonts directory and all its subdirectories as well.) |
subdirectories as well.) The bin subdirectory should be added to your |
833 |
The bin subdirectory should be added to your PATH. The msdos |
PATH. The msdos subdirectory includes a PIF and an icon file for |
834 |
subdirectory includes a PIF and an icon file for Emacs which you might |
Emacs which you might find useful if you run Emacs under MS Windows. |
|
find useful if you run Emacs under MS Windows. |
|
835 |
|
|
836 |
Emacs on MSDOS finds the lisp, etc and info directories by looking in |
Emacs on MSDOS finds the lisp, etc and info directories by looking in |
837 |
../lisp, ../etc and ../info, starting from the directory where the |
../lisp, ../etc and ../info, starting from the directory where the |