comparison nt/INSTALL @ 67016:47fccd30153d

Rearrange text to make it clear that the make/shell compatibility table refers only to the MinGW build.
author Eli Zaretskii <eliz@gnu.org>
date Sat, 19 Nov 2005 13:19:58 +0000
parents 3723093a21fd
children dc47c26ee643
comparison
equal deleted inserted replaced
67015:21e2e3358403 67016:47fccd30153d
27 "touch.exe" in your path, and that it will create files that do not 27 "touch.exe" in your path, and that it will create files that do not
28 yet exist. 28 yet exist.
29 29
30 To compile Emacs, you will need either Microsoft Visual C++ 2.0 or 30 To compile Emacs, you will need either Microsoft Visual C++ 2.0 or
31 later and nmake, or a Windows port of GCC 2.95 or later with MinGW 31 later and nmake, or a Windows port of GCC 2.95 or later with MinGW
32 and W32 API support and a port of GNU make. You can use the Cygwin 32 and W32 API support and a port of GNU Make. You can use the Cygwin
33 ports of GCC, but Emacs requires the MinGW headers and libraries to 33 ports of GCC, but Emacs requires the MinGW headers and libraries to
34 build (latest versions of the Cygwin toolkit, at least since v1.3.3, 34 build (latest versions of the Cygwin toolkit, at least since v1.3.3,
35 include the MinGW headers and libraries as an integral part). 35 include the MinGW headers and libraries as an integral part).
36 36
37 Other compilers may work, but specific reports from people that have 37 If you use the MinGW port of GCC and GNU Make to build Emacs, there
38 tried suggest that the Intel C compiler (for example) may produce an 38 are some compatibility issues wrt Make and the shell that is run by
39 Emacs executable with strange filename completion behaviour. Unless 39 Make, either the standard COMMAND.COM/CMD.EXE supplied with Windows
40 you would like to assist by finding and fixing the cause of any bugs 40 or sh.exe., a port of a Unixy shell. For reference, here is a list
41 like this, we recommend the use of the supported compilers mentioned 41 of which builds of GNU Make are known to work or not, and whether
42 in the previous paragraph. 42 they work in the presence and/or absence of sh.exe, the Cygwin port
43 43 of Bash. Note that any version of Make that is compiled with Cygwin
44 You will also need a copy of the Posix cp, rm and mv programs. These 44 will only work with Cygwin tools, due to the use of cygwin style
45 and other useful Posix utilities can be obtained from one of several 45 paths. This means Cygwin Make is unsuitable for building parts of
46 projects: 46 Emacs that need to invoke Emacs itself (leim and "make bootstrap",
47 47 for example). Also see the Trouble-shooting section below if you
48 * http://www.mingw.org/ ( MinGW ) 48 decide to go ahead and use Cygwin make.
49 * http://www.cygwin.com/ ( Cygwin )
50 * http://unxutils.sourceforge.net/ ( UnxUtils )
51 * http://gnuwin32.sourceforge.net/ ( GnuWin32 )
52
53 If you build Emacs on Windows 9X or ME, not on Windows 2K/XP or
54 Windows NT, we suggest to install the Cygwin port of Bash.
55
56 Additional instructions and help for building Emacs on Windows can be
57 found at the Emacs Wiki:
58
59 http://www.emacswiki.org/cgi-bin/wiki/WThirtyTwoInstallationKit
60
61 and at this URL:
62
63 http://ourcomments.org/Emacs/w32-build-emacs.html
64
65 For reference, here is a list of which builds of GNU make are known
66 to work or not, and whether they work in the presence and/or absence
67 of sh.exe, the Cygwin port of Bash. Note that any version of make
68 that is compiled with Cygwin will only work with Cygwin tools, due to
69 the use of cygwin style paths. This means Cygwin make is unsuitable
70 for building parts of Emacs that need to invoke Emacs itself (leim and
71 "make bootstrap", for example). Also see the Trouble-shooting section
72 below if you decide to go ahead and use Cygwin make.
73 49
74 In addition, using 4NT as your shell is known to fail the build process, 50 In addition, using 4NT as your shell is known to fail the build process,
75 at least for 4NT version 3.01. Use cmd.exe, the default NT shell, 51 at least for 4NT version 3.01. Use CMD.EXE, the default Windows shell,
76 instead. MSYS sh.exe also appears to cause various problems. If you have 52 instead. MSYS sh.exe also appears to cause various problems. If you have
77 MSYS installed, try "make SHELL=cmd.exe" to force the use of cmd.exe 53 MSYS installed, try "make SHELL=cmd.exe" to force the use of cmd.exe
78 instead of sh.exe. 54 instead of sh.exe.
79 55
80 sh exists no sh 56 sh exists no sh
99 versions of cygwin. 75 versions of cygwin.
100 [4] may fail on Windows 9X and Windows ME; if so, install Bash. 76 [4] may fail on Windows 9X and Windows ME; if so, install Bash.
101 [5] fails when building leim due to the use of cygwin style paths. 77 [5] fails when building leim due to the use of cygwin style paths.
102 May work if building emacs without leim. 78 May work if building emacs without leim.
103 [6] please report if you try this combination. 79 [6] please report if you try this combination.
80
81 Other compilers may work, but specific reports from people that have
82 tried suggest that the Intel C compiler (for example) may produce an
83 Emacs executable with strange filename completion behaviour. Unless
84 you would like to assist by finding and fixing the cause of any bugs
85 like this, we recommend the use of the supported compilers mentioned
86 in the previous paragraph.
87
88 You will also need a copy of the Posix cp, rm and mv programs. These
89 and other useful Posix utilities can be obtained from one of several
90 projects:
91
92 * http://www.mingw.org/ ( MinGW )
93 * http://www.cygwin.com/ ( Cygwin )
94 * http://unxutils.sourceforge.net/ ( UnxUtils )
95 * http://gnuwin32.sourceforge.net/ ( GnuWin32 )
96
97 If you build Emacs on Windows 9X or ME, not on Windows 2K/XP or
98 Windows NT, we suggest to install the Cygwin port of Bash.
99
100 Additional instructions and help for building Emacs on Windows can be
101 found at the Emacs Wiki:
102
103 http://www.emacswiki.org/cgi-bin/wiki/WThirtyTwoInstallationKit
104
105 and at this URL:
106
107 http://ourcomments.org/Emacs/w32-build-emacs.html
104 108
105 * Configuring 109 * Configuring
106 110
107 Configuration of Emacs is now handled by running configure.bat in the 111 Configuration of Emacs is now handled by running configure.bat in the
108 nt subdirectory. It will detect which compiler you have available, 112 nt subdirectory. It will detect which compiler you have available,