annotate nt/install @ 12177:ef0dcc3a18fd

changed referendce to of makefile.nt to makedffile.def in configure section
author Geoff Voelker <voelker@cs.washington.edu>
date Sat, 10 Jun 1995 00:03:02 +0000
parents 665d617c21de
children 531750bd747b
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.
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
14
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
15 (2) Choose the directory into which Emacs will be installed, and
12177
ef0dcc3a18fd changed referendce to of makefile.nt to makedffile.def in configure section
Geoff Voelker <voelker@cs.washington.edu>
parents: 11935
diff changeset
16 edit makefile.def to define INSTALL_DIR to be this directory. Note
11935
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
17 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
18 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
19
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
20 Also, makefile.def is sometimes unpacked read-only; use
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
21
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
22 > attrib -r makefile.def
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
23
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
24 to make it writable.
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
25
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
26 Building:
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
27
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
28 (3) The target to compile the sources is "all", and is recursive starting
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
29 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
30 "makefile.nt". To get things started, type in this directory:
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
31
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
32 > nmake -f makefile.nt all
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
33
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
34 or use the ebuild.bat file.
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
35
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
36 When the files are compiled, you will see some warning messages declaring
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
37 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
38 will be lossy, etc. You can safely ignore these messages. The warnings
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
39 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
40 will just live with them.
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 NOTES: You should not have to edit src\paths.h to get Emacs to run
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
43 correctly. All of the variables in src\paths.h are configured
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
44 during start up using the nt\emacs.bat file (which gets installed
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
45 as bin\emacs.bat -- see below).
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
46
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
47 Installing:
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
48
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
49 (4) Currently, Emacs requires a number of environment variables to be set
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
50 for it to run correctly. A batch file, emacs.bat, is provided that
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
51 sets these variables appropriately and then runs the executable.
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
52 Before you install Emacs, you first need to edit emacs.bat to
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
53 reflect your installation. To do this, set the emacs_path variable
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
54 to point to the directory into which you will be installing Emacs.
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
55 (This should be the same directory you defined INSTALL_DIR to be
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
56 in makefile.def above).
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
57
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
58 (5) Install Emacs. From this directory, type:
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
59
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
60 > nmake -f makefile.nt install
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
61
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
62 or use the install.bat file.
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
63
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
64 (6) Create the Emacs startup file. Under Unix, this file is .emacs;
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
65 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
66 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
67 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
68 .emacs file that you would like to load.) Note that Emacs requires
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
69 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
70 _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
71 as it will be different for each user. (HOME could be set,
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
72 for example, in the System panel of the Control Panel).
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
73
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
74 (7) Create a program manager icon for the %emacs_path%\emacs.bat file.
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
75
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
76 (8) Either click on the icon, or run the emacs.bat file, and away you go.
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
77
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
78 If you would like to resize the command window that Emacs uses,
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
79 or change the font or colors, click on the program manager icon
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
80 to start Emacs. Change the settings using the "-" menu in the upper
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
81 left hand corner of the window, making sure to select the "Save"
665d617c21de Initial revision
Geoff Voelker <voelker@cs.washington.edu>
parents:
diff changeset
82 options in the dialog boxes as you do so. Exit Emacs and restart.