Mercurial > emacs
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, |