Commit | Line | Data |
---|---|---|
8553c409 GV |
1 | Building and Installing Emacs |
2 | on Windows NT and Windows 95 | |
3 | ||
4 | You need a compiler package to build and install Emacs on NT or Win95. | |
5 | If you don't have one, precompiled versions are available in | |
6 | ftp://ftp.cs.washington.edu/pub/ntemacs/<version>. | |
7 | ||
8 | Configuring: | |
9 | ||
10 | (1) In previous versions, you needed to edit makefile.def | |
11 | to reflect the compiler package that you are using. You should no | |
12 | longer have to do this if you have defined the INCLUDE and LIB | |
13 | environment variables, as is customary for use with Windows compilers. | |
851359de GV |
14 | (Unless you are using MSVCNT 1.1, in which case you will need |
15 | to set MSVCNT11 to be a non-zero value at the top of makefile.def.) | |
8553c409 GV |
16 | |
17 | (2) Choose the directory into which Emacs will be installed, and | |
fe4163b1 GV |
18 | edit makefile.def to define INSTALL_DIR to be this directory. |
19 | (Alternatively, if you have INSTALL_DIR set as an environment | |
20 | variable, the build process will ignore the value in makefile.def | |
21 | and use the value of the environment variable instead.) Note | |
8553c409 GV |
22 | that if it is not installed in the directory in which it is built, |
23 | the ~16 MB of lisp files will be copied into the installation directory. | |
24 | ||
25 | Also, makefile.def is sometimes unpacked read-only; use | |
26 | ||
27 | > attrib -r makefile.def | |
28 | ||
29 | to make it writable. | |
30 | ||
3f8bae90 RS |
31 | (3) You may need to edit nt/paths.h to specify some other device |
32 | instead of `C:'. | |
33 | ||
8553c409 GV |
34 | Building: |
35 | ||
3f8bae90 | 36 | (4) The target to compile the sources is "all", and is recursive starting |
8553c409 GV |
37 | one directory up. The makefiles for the NT port are in files named |
38 | "makefile.nt". To get things started, type in this directory: | |
39 | ||
40 | > nmake -f makefile.nt all | |
41 | ||
42 | or use the ebuild.bat file. | |
43 | ||
44 | When the files are compiled, you will see some warning messages declaring | |
45 | that some functions don't return a value, or that some data conversions | |
46 | will be lossy, etc. You can safely ignore these messages. The warnings | |
47 | may be fixed in the main FSF source at some point, but until then we | |
48 | will just live with them. | |
49 | ||
515f7b32 | 50 | NOTE: You should not have to edit src\paths.h to get Emacs to run |
8553c409 GV |
51 | correctly. All of the variables in src\paths.h are configured |
52 | during start up using the nt\emacs.bat file (which gets installed | |
53 | as bin\emacs.bat -- see below). | |
54 | ||
55 | Installing: | |
56 | ||
3f8bae90 | 57 | (5) Currently, Emacs requires a number of environment variables to be set |
8553c409 | 58 | for it to run correctly. A batch file, emacs.bat, is provided that |
515f7b32 GV |
59 | sets these variables appropriately and then runs the executable |
60 | (emacs.bat is generated using the definition of INSTALL_DIR in | |
61 | nt\makefile.def and the contents of nt\emacs.bat.in). | |
8553c409 | 62 | |
3f8bae90 | 63 | (6) The install process will install the files necessary to run Emacs in |
515f7b32 GV |
64 | INSTALL_DIR (which may be the directory in which it was built), |
65 | and create a program manager/folder icon in a folder called GNU Emacs. | |
66 | From this directory, type: | |
8553c409 GV |
67 | |
68 | > nmake -f makefile.nt install | |
69 | ||
70 | or use the install.bat file. | |
71 | ||
3f8bae90 | 72 | (7) Create the Emacs startup file. Under Unix, this file is .emacs; |
8553c409 GV |
73 | under NT and Win95, this files is _emacs. (If you would like to |
74 | use a .emacs file that, for example, you share with a Unix version | |
75 | of Emacs, you can invoke Emacs with the -l option to specify the | |
76 | .emacs file that you would like to load.) Note that Emacs requires | |
77 | the environment variable HOME to be set in order for it to locate the | |
78 | _emacs file. Ideally, HOME should not be set in the emacs.bat file | |
79 | as it will be different for each user. (HOME could be set, | |
80 | for example, in the System panel of the Control Panel). | |
81 | ||
3f8bae90 | 82 | (8) Either click on the icon, or run the emacs.bat file, and away you go. |
8553c409 GV |
83 | |
84 | If you would like to resize the command window that Emacs uses, | |
85 | or change the font or colors, click on the program manager icon | |
86 | to start Emacs. Change the settings using the "-" menu in the upper | |
87 | left hand corner of the window, making sure to select the "Save" | |
88 | options in the dialog boxes as you do so. Exit Emacs and restart. |