annotate nt/install @ 20528:4ffe5887d8c6

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