annotate nt/README @ 276:6330739388db r21-0b36

Import from CVS: tag r21-0b36
author cvs
date Mon, 13 Aug 2007 10:30:37 +0200
parents 1f0dabaa0855
children 70ad99077275
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
169
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
1 Building and Installing XEmacs on Windows NT
155
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
2
169
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
3 David Hobley
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
4 Marc Paquette
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents: 213
diff changeset
5 Jonathan Harris
155
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
6
213
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
7 Currently XEmacs for Win32 is in an early stage of development.
155
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
8
169
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
9 The port was made much easier by the groundbreaking work of Geoff Voelker
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
10 and others who worked on the GNU Emacs port to NT. Their version is available
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
11 from http://www.cs.washington.edu/homes/voelker/ntemacs.html
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
12
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
13 To get it working you will need:
155
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
14
213
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
15 1. You will need Visual C++ V4.2 or later to compile everything. Personally we
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
16 have tested V4.2 and V5.0.
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
17 Note that Visual C++ assumes a couple of environment variables INCLUDE and
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
18 LIB to be set which specify the location of the includes and libraries.
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
19 At this point you can select X or Win32 native support.
276
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
20 2. Grab the latest XEmacs beta from ftp.xemacs.org if necessary. All Win32
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
21 support is in the nt/ subdirectory. You'll also need the xemacs-base
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
22 package from the binary-packages subdirectory and you'll probably alsi
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
23 want at least the edit-utils, text-utils, cc-mode and prog-utils packages.
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
24 Unpack the packages into, say, c:\src\xemacs\packages.
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
25
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
26 If you want to build for native GUI:
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
27
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
28 1. If you want XPM and toolbar support grab the latest version of the xpm
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
29 sources (xpm-3.4k.tar.gz at time of writing) and unpack it.
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
30 Copy nt/xpm.mak from the xemacs distribution to the lib subdirectory of
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
31 the xpm distribution, cd to that directory and build xpm with
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
32 `nmake -f xpm.mak`.
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
33 2. cd to the nt subdirectory of the xemacs distribution and build xemacs:
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
34 `nmake -f xemacs.mak HAVE_MSW=1 PATH_PACKAGEPATH="c:/src/xemacs/packages"`,
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
35 replacing "c:/src/xemacs/packages" with the location of your packages. Note
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
36 the double quotes and *forward* slashes in that path.
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
37 If you're building with XPM support, add this to the nmake command line:
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
38 `HAVE_XPM=1 XPM_DIR=x:\location\of\your\xpm\source\tree`.
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
39 Nmake will build temacs, the DOC file, update the elc's and dump xemacs.
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
40 3. The build process creates debugging and "Source Browser" information for
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
41 use with MS DevStudio. To use this create a new "console" project and
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
42 under Project/Settings set:
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
43 Debug: executable name = full path of src\xemacs.exe
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
44 Link: output file name = full path of src\temacs.exe
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
45 Browse Info: browse info file name = full path of src\temacs.bsc
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
46 Remember to close the Source Browser file in DevStudio before rebuilding.
213
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
47
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
48 If you want support for X you will need:
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
49
195
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
50 1. An X server. MI/X is available on the Internet for free; It is
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
51 available from: http://www.microimages.com/www/html/freestuf/mixdlfrm.htm
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
52 2. The MIT X11R6.3 libraries available from: ftp.x.org
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
53 3. You'll need to compile the MIT libraries without multi-thread support.
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
54 To do this, there is an example Win32.cf and site.def provided which
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
55 set the relevant flags. You will also need to apply the patch in
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
56 nt/X11.patch in the xc/lib/X11 directory which will fix the DLL definition
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
57 file. Once compiled and installed, you will need to apply the following
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
58 patch to Xmd.h. This is messy and better solutions would be appreciated.
276
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
59 4. Goto 2 under 'native GUI' above and also supply:
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
60 `HAVE_X=1 X11_DIR=x:\root\directory\of\your\X11\installation'
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 215
diff changeset
61 to the nmake command line.
155
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
62
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
63 --- Xmd.h~ Thu Jun 08 23:20:40 1995
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
64 +++ Xmd.h Sun Mar 16 13:09:10 1997
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
65 @@ -150,8 +150,9 @@
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
66 typedef CARD16 BITS16;
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
67 typedef CARD8 BYTE;
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
68
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
69 +#ifndef WIN32
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
70 typedef CARD8 BOOL;
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
71 -
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
72 +#endif
195
a2f645c6b9f8 Import from CVS: tag r20-3b24
cvs
parents: 169
diff changeset
73
169
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
74 Known Problems:
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
75 Please look at the TODO list for the current list of problems and people
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
76 working on them.
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
77
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
78 Any other problems you need clarified, please email us and we will endeavour
15872534500d Import from CVS: tag r20-3b11
cvs
parents: 155
diff changeset
79 to provide any assistance we can:
155
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
80
213
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
81 The XEmacs NT Mailing List: xemacs-nt@xemacs.org
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
82 Subscribe address: xemacs-nt-request@xemacs.org
155
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
83
213
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
84 David Hobley
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
85 Marc Paquette
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
86 August Hill
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents: 213
diff changeset
87 Jonathan Harris
155
43dd3413c7c7 Import from CVS: tag r20-3b4
cvs
parents: 100
diff changeset
88
213
78f53ef88e17 Import from CVS: tag r20-4b5
cvs
parents: 195
diff changeset
89 and others.