diff options
| -rw-r--r-- | INSTALL | 111 |
1 files changed, 5 insertions, 106 deletions
| @@ -207,9 +207,9 @@ corresponding command is `yum-builddep emacs'. | |||
| 207 | 207 | ||
| 208 | DETAILED BUILDING AND INSTALLATION: | 208 | DETAILED BUILDING AND INSTALLATION: |
| 209 | 209 | ||
| 210 | (This is for a Unix or Unix-like system. For MS-DOS and MS Windows 3.X, | 210 | (This is for a Unix or Unix-like system. For GNUstep and Mac OS X, |
| 211 | see msdos/INSTALL. For later versions of MS Windows, see the file | 211 | see nextstep/INSTALL. For non-ancient versions of MS Windows, see |
| 212 | nt/INSTALL. For GNUstep and Mac OS X, see nextstep/INSTALL.) | 212 | the file nt/INSTALL. For MS-DOS and MS Windows 3.X, see msdos/INSTALL.) |
| 213 | 213 | ||
| 214 | 1) See the basic installation summary above for the disk space requirements. | 214 | 1) See the basic installation summary above for the disk space requirements. |
| 215 | 215 | ||
| @@ -359,8 +359,7 @@ without sound support. | |||
| 359 | `configure' doesn't do any compilation or installation itself. | 359 | `configure' doesn't do any compilation or installation itself. |
| 360 | It just creates the files that influence those things: | 360 | It just creates the files that influence those things: |
| 361 | `./Makefile' in the top-level directory and several subdirectories; | 361 | `./Makefile' in the top-level directory and several subdirectories; |
| 362 | and `./src/config.h'. For details on exactly what it does, see the | 362 | and `./src/config.h'. |
| 363 | section called `CONFIGURATION BY HAND', below. | ||
| 364 | 363 | ||
| 365 | When it is done, `configure' prints a description of what it did and | 364 | When it is done, `configure' prints a description of what it did and |
| 366 | creates a shell script `config.status' which, when run, recreates the | 365 | creates a shell script `config.status' which, when run, recreates the |
| @@ -415,11 +414,6 @@ those libraries are. For example: | |||
| 415 | ./configure \ | 414 | ./configure \ |
| 416 | PKG_CONFIG_PATH='/usr/local/alsa/lib/pkgconfig:/opt/gtk+-2.8/lib/pkgconfig' | 415 | PKG_CONFIG_PATH='/usr/local/alsa/lib/pkgconfig:/opt/gtk+-2.8/lib/pkgconfig' |
| 417 | 416 | ||
| 418 | The work of `configure' can be done by editing various files in the | ||
| 419 | distribution, but using `configure' is easier. See the section called | ||
| 420 | "CONFIGURATION BY HAND" below if you want to do the configuration | ||
| 421 | yourself. | ||
| 422 | |||
| 423 | 3b) To build in a separate directory, go to that directory | 417 | 3b) To build in a separate directory, go to that directory |
| 424 | and run the program `configure' as follows: | 418 | and run the program `configure' as follows: |
| 425 | 419 | ||
| @@ -429,9 +423,6 @@ SOURCE-DIR refers to the top-level Emacs source directory which is | |||
| 429 | where Emacs's configure script is located. `configure' looks for the | 423 | where Emacs's configure script is located. `configure' looks for the |
| 430 | Emacs source code in the directory that `configure' is in. | 424 | Emacs source code in the directory that `configure' is in. |
| 431 | 425 | ||
| 432 | (Do not try to build in a separate directory by creating many links to | ||
| 433 | the real source directory--there is no need, and installation will fail.) | ||
| 434 | |||
| 435 | 4) Put into `./lisp/site-init.el' or `./lisp/site-load.el' any Emacs | 426 | 4) Put into `./lisp/site-init.el' or `./lisp/site-load.el' any Emacs |
| 436 | Lisp code you want Emacs to load before it is dumped out. Use | 427 | Lisp code you want Emacs to load before it is dumped out. Use |
| 437 | site-load.el for additional libraries if you arrange for their | 428 | site-load.el for additional libraries if you arrange for their |
| @@ -544,11 +535,7 @@ to enable it to write the lock files. We believe this is safe. | |||
| 544 | 9) You are done! You can remove executables and object files from | 535 | 9) You are done! You can remove executables and object files from |
| 545 | the build directory by typing `make clean'. To also remove the files | 536 | the build directory by typing `make clean'. To also remove the files |
| 546 | that `configure' created (so you can compile Emacs for a different | 537 | that `configure' created (so you can compile Emacs for a different |
| 547 | configuration), type `make distclean'. If you don't need some, or all | 538 | configuration), type `make distclean'. |
| 548 | of the input methods from the Leim package, you can remove the | ||
| 549 | unneeded files in the leim subdirectories of your site's lisp | ||
| 550 | directory (usually /usr/local/share/emacs/VERSION/). | ||
| 551 | |||
| 552 | 539 | ||
| 553 | 540 | ||
| 554 | MAKE VARIABLES | 541 | MAKE VARIABLES |
| @@ -656,94 +643,6 @@ Makefiles for the subdirectories, so you don't have to specify them | |||
| 656 | when running make in the subdirectories. | 643 | when running make in the subdirectories. |
| 657 | 644 | ||
| 658 | 645 | ||
| 659 | CONFIGURATION BY HAND | ||
| 660 | |||
| 661 | This should not be necessary and is not recommended. Instead of | ||
| 662 | running the `configure' program, you have to perform the following steps. | ||
| 663 | |||
| 664 | 1) Copy `./src/config.in' to `./src/config.h'. | ||
| 665 | |||
| 666 | 2) Edit `./src/config.h' to set the right options for your system. | ||
| 667 | |||
| 668 | 3) Create `Makefile' files in various directories from the | ||
| 669 | corresponding `Makefile.in' files. This isn't so hard, just a matter | ||
| 670 | of editing in appropriate substitutions for the @...@ constructs. | ||
| 671 | |||
| 672 | The `configure' script is built from `configure.ac' by the | ||
| 673 | `autogen.sh' script, which checks that `autoconf' and other build | ||
| 674 | tools are sufficiently up to date and then runs the build tools. | ||
| 675 | |||
| 676 | BUILDING GNU EMACS BY HAND | ||
| 677 | |||
| 678 | Once Emacs is configured, running `make' in the top directory performs | ||
| 679 | the following steps. | ||
| 680 | |||
| 681 | 1) Run `make epaths-force' in the top directory. This produces | ||
| 682 | `./src/epaths.h' from the template file `./src/epaths.in', changing | ||
| 683 | the paths to the values specified in `./Makefile'. | ||
| 684 | |||
| 685 | 2) Go to directory `./lib' and run `make'. This creates include files | ||
| 686 | and libraries used in later steps. | ||
| 687 | |||
| 688 | 3) Go to directory `./lib-src' and run `make'. This creates | ||
| 689 | executables named `etags', `make-docfile', and others. | ||
| 690 | |||
| 691 | 4) Go to directory `./src' and run `make'. This refers to files in | ||
| 692 | the `./lisp', `./lib', and `./lib-src' subdirectories using names | ||
| 693 | `../lisp', `../lib', and `../lib-src'. | ||
| 694 | |||
| 695 | This creates a file `./src/emacs' which is the runnable Emacs, | ||
| 696 | which has another name that contains a version number. | ||
| 697 | Each time you do this, that version number increments in the last place. | ||
| 698 | |||
| 699 | It also creates a file in `./etc' whose name is `DOC' followed by the | ||
| 700 | current Emacs version. This file contains documentation strings for | ||
| 701 | all the functions in Emacs. Each time you run make to make a new | ||
| 702 | emacs, a new DOC file with a new name is made. You must keep the DOC | ||
| 703 | file for an Emacs version as long as you keep using that Emacs version. | ||
| 704 | |||
| 705 | |||
| 706 | INSTALLATION BY HAND | ||
| 707 | |||
| 708 | The steps below are done by running `make install' in the main | ||
| 709 | directory of the Emacs distribution. | ||
| 710 | |||
| 711 | 1) Copy `./lisp' and its subdirectories, `./etc', and the executables | ||
| 712 | in `./lib-src' to their final destinations, as selected in `./src/epaths.h'. | ||
| 713 | |||
| 714 | Strictly speaking, not all of the executables in `./lib-src' need be copied. | ||
| 715 | - The programs `hexl', `movemail', `profile', and `rcs2log' | ||
| 716 | are used by Emacs; they do need to be copied. | ||
| 717 | - The programs `etags', `ctags', and `emacsclient' are intended to be | ||
| 718 | run by users; they are handled below. | ||
| 719 | - The program `make-docfile' was used in building Emacs, and is | ||
| 720 | not needed any more. | ||
| 721 | |||
| 722 | 2) Copy the files in `./info' to the place specified in | ||
| 723 | `./lisp/site-init.el' or `./lisp/info.el'. Note that if the | ||
| 724 | destination directory already contains a file named `dir', you | ||
| 725 | probably don't want to replace it with the `dir' file in the Emacs | ||
| 726 | distribution. Instead, you should make sure that the existing `dir' | ||
| 727 | file contains an appropriate menu entry for the Emacs info. | ||
| 728 | |||
| 729 | 3) Copy `./src/emacs' to `/usr/local/bin', or to some other directory | ||
| 730 | in users' search paths. `./src/emacs' has an alternate name | ||
| 731 | `./src/emacs-EMACSVERSION'; you may wish to make a symbolic link named | ||
| 732 | `/usr/local/bin/emacs' pointing to that alternate name, as an easy way | ||
| 733 | of installing different versions. | ||
| 734 | |||
| 735 | You can delete `./src/temacs'. | ||
| 736 | |||
| 737 | 4) Copy the programs `emacsclient', `ctags', and `etags' from `./lib-src' | ||
| 738 | to `/usr/local/bin'. These programs are intended for users to run. | ||
| 739 | |||
| 740 | 5) Copy the man pages in `./doc/man' into the appropriate man directory. | ||
| 741 | |||
| 742 | 6) The files in the `./src' subdirectory, except for `emacs', are not | ||
| 743 | used by Emacs once it is built. However, it is very desirable to keep | ||
| 744 | the source on line for debugging. | ||
| 745 | |||
| 746 | |||
| 747 | PROBLEMS | 646 | PROBLEMS |
| 748 | 647 | ||
| 749 | See the file `./etc/PROBLEMS' for a list of various problems sometimes | 648 | See the file `./etc/PROBLEMS' for a list of various problems sometimes |