diff options
| author | Eli Zaretskii | 2005-11-19 13:19:58 +0000 |
|---|---|---|
| committer | Eli Zaretskii | 2005-11-19 13:19:58 +0000 |
| commit | 6c72c0c7d6cf03b9079a0768fa64879b97dd53bd (patch) | |
| tree | 4ce50199cf5e680a2ae1c3f52c6407492b9a1458 | |
| parent | ad8121fe5d0077621b93eabdb294834591d0475d (diff) | |
| download | emacs-6c72c0c7d6cf03b9079a0768fa64879b97dd53bd.tar.gz emacs-6c72c0c7d6cf03b9079a0768fa64879b97dd53bd.zip | |
Rearrange text to make it clear that the make/shell compatibility
table refers only to the MinGW build.
| -rw-r--r-- | nt/INSTALL | 80 |
1 files changed, 42 insertions, 38 deletions
diff --git a/nt/INSTALL b/nt/INSTALL index ed960b06bdd..2fb673d47d2 100644 --- a/nt/INSTALL +++ b/nt/INSTALL | |||
| @@ -29,50 +29,26 @@ | |||
| 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. |
| @@ -102,6 +78,34 @@ | |||
| 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. |
| 104 | 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 | ||
| 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 |