/[emacs]/emacs/INSTALL
ViewVC logotype

Diff of /emacs/INSTALL

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.81 by eliz, Sat Nov 10 14:51:07 2001 UTC revision 1.82 by eliz, Fri Dec 21 08:56:39 2001 UTC
# Line 1  Line 1 
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    
# Line 21  maybe perform some of the steps manually Line 21  maybe perform some of the steps manually
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    
# Line 44  that, so please refer to them if the sim Line 37  that, so please refer to them if the sim
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
# Line 62  that, so please refer to them if the sim Line 55  that, so please refer to them if the sim
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    
# Line 98  that, so please refer to them if the sim Line 91  that, so please refer to them if the sim
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
# Line 207  insufficient, you will get an error in t Line 180  insufficient, you will get an error in t
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
# Line 805  To unpack Emacs with djtar, type this co Line 777  To unpack Emacs with djtar, type this co
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
# Line 864  sibling directory called bin.  For examp Line 828  sibling directory called bin.  For examp
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

Legend:
Removed from v.1.81  
changed lines
  Added in v.1.82

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26