mirror of
https://git.savannah.gnu.org/git/make.git
synced 2024-12-24 21:04:00 +00:00
aa44e66c8f
Over time the non-standard build and install systems (nmake files, smake files, Visual Studio project files, etc.) have atrophied and maintaining them is not worth the effort, for such a simple utility as make. Remove all the non-standard build tool support and unify OS-specific build rules under a basic set of (GNU make) makefiles. Preserve the existing bootstrapping scripts (for POSIX, Windows, and MS-DOS). Also the existing VMS build scripts are left unchanged: I don't have enough experience with VMS to venture into this area. Perhaps one of the VMS maintainers might like to determine whether conversion would be appropriate. Rather than create libraries for w32 and glob (non-POSIX), simply link the object files directly to remove the complexity. * NEWS: Update with user-facing notes. * Makefile.am: Clean up to use the latest automake best practices. Build Windows code directly from the root makefile to avoid recursion. * README.Amiga, README.DOS.template, README.W32.template: Updated. * INSTALL: Point readers at the README.git file. * maintMakefile: Remove obsolete files. Create Basic.mk file. * Basic.mk.template, mk/*.mk: Create basic GNU make-based makefiles. * build_w32.bat: Copy Basic.mk to Makefile * configure.ac: We no longer need AM_PROG_AR. * dosbuild.bat: Rename to builddos.bat. Incorporate configure.bat. * Makefile.DOS.template: Remove. * NMakefile.template, w32/subproc/NMakefile: Remove. * SMakefile.template, glob/SMakefile, glob/SCOPTIONS, make.lnk: Remove. * configure.bat, glob/configure.bat: Remove. * w32/Makefile.am: Remove. * make_msvc_net2003.sln, make_msvc_net2003.vcproj: Remove.
361 lines
15 KiB
Text
361 lines
15 KiB
Text
This version of GNU make has been tested on:
|
||
Microsoft Windows 2000/XP/2003/Vista/7/8/10
|
||
It has also been used on Windows 95/98/NT, and on OS/2.
|
||
|
||
It builds with the MinGW port of GCC (tested with GCC 3.4.2, 4.8.1,
|
||
and 4.9.3).
|
||
|
||
It also builds with MSVC 2.x, 4.x, 5.x, 6.x, 2005, 2008, 2010, 2012,
|
||
2013, and 2015 as well as with .NET 7.x and .NET 2003.
|
||
|
||
Building with Guile is supported (tested with Guile 2.0.x). To build
|
||
with Guile, you will need, in addition to Guile itself, its dependency
|
||
libraries and the pkg-config program. The latter is used to figure out
|
||
which compilation and link switches and libraries need to be mentioned
|
||
on the compiler command lines to correctly link with Guile. A Windows
|
||
port of pkg-config can be found on ezwinports site:
|
||
|
||
http://sourceforge.net/projects/ezwinports/
|
||
|
||
The libraries on which Guile depends can vary depending on your
|
||
version and build of Guile. At the very least, the Boehm's GC library
|
||
will be needed, and typically also GNU MP, libffi, libunistring, and
|
||
libtool's libltdl. Whoever built the port of Guile you have should
|
||
also provide you with these dependencies or a URL where to download
|
||
them. A precompiled 32-bit Windows build of Guile is available from
|
||
the ezwinports site mentioned above.
|
||
|
||
The Windows port of GNU make is maintained jointly by various people.
|
||
It was originally made by Rob Tulloh.
|
||
It is currently maintained by Eli Zaretskii.
|
||
|
||
|
||
Do this first, regardless of the build method you choose:
|
||
---------------------------------------------------------
|
||
|
||
1. Edit config.h.W32 to your liking (especially the few shell-related
|
||
defines near the end, or HAVE_CASE_INSENSITIVE_FS which corresponds
|
||
to './configure --enable-case-insensitive-file-system'). (We don't
|
||
recommend to define HAVE_CASE_INSENSITIVE_FS, but you may wish to
|
||
consider that if you have a lot of files whose names are in upper
|
||
case, while Makefile rules are written for lower-case versions.)
|
||
|
||
|
||
Building with (MinGW-)GCC using build_w32.bat
|
||
---------------------------------------------
|
||
|
||
2. Open a W32 command prompt for your installed (MinGW-)GCC, setup a
|
||
correct PATH and other environment variables for it, then execute ...
|
||
|
||
.\build_w32.bat gcc
|
||
|
||
This produces gnumake.exe in the GccRel directory.
|
||
|
||
If you want a version of GNU make built with debugging enabled,
|
||
add the --debug option. Output goes into the GccDebug directory.
|
||
|
||
The batch file will probe for Guile installation, and will build
|
||
gnumake.exe with Guile if it finds it. If you have Guile
|
||
installed, but want to build Make without Guile support, type
|
||
|
||
.\build_w32.bat --without-guile gcc
|
||
|
||
|
||
Building with (MSVC++-)cl using build_w32.bat
|
||
---------------------------------------------
|
||
|
||
2. Open a command shell, then execute ...
|
||
|
||
.\build_w32.bat
|
||
|
||
This produces a 64bit Release build of gnumake.exe in .\WinRel, using
|
||
the compiler found on the %Path%. If no compiler is found, the batch
|
||
file will probe your system and choose the newest MSVC version it can
|
||
find.
|
||
|
||
If you want a 32bit version of GNU make, add the --x86 option.
|
||
|
||
If you want a Debug build of GNU make, add the --debug option. Output
|
||
will go into the .\WinDebug directory.
|
||
|
||
The batch file will probe for Guile installation, and will build
|
||
gnumake.exe with Guile if it finds it. If Guile is installed,
|
||
but you prefer to build GNU make without Guile support, add the
|
||
--without-guile option.
|
||
|
||
|
||
Building with (MinGW-)GCC using GNU make
|
||
----------------------------------------
|
||
|
||
2. If you already have a version of GNU make available you can use it
|
||
to build this version. Open a W32 command prompt for your installed
|
||
(MinGW-)GCC, setup a correct PATH and other environment variables
|
||
for it, then execute ...
|
||
|
||
make -f Basic.mk TOOLCHAIN=gcc
|
||
|
||
This produces GccRel\gnumake.exe.
|
||
If you want a version of GNU make built with debugging enabled,
|
||
add the TARGET_TYPE=debug option:
|
||
|
||
make -f Basic.mk TOOLCHAIN=gcc TARGET_TYPE=debug
|
||
|
||
The makefile doesn't support Guile integration. Use build_w32.bat
|
||
if you want to build with Guile support.
|
||
|
||
|
||
Building with (MSVC++-)cl using GNU make
|
||
----------------------------------------
|
||
|
||
2. If you already have a version of GNU make available you can use it
|
||
to build this version. Open a W32 command prompt for your installed
|
||
(MSVC++-)cl, setup a correct PATH and other environment variables
|
||
for it (usually via executing vcvars32.bat or vsvars32.bat from the
|
||
cl-installation, or using a corresponding start menu entry from the
|
||
cl-installation), then execute ...
|
||
|
||
make -f Basic.mk
|
||
|
||
This produces an optimized WinRel/gnumake.exe.
|
||
If you want a version of GNU make built with debugging enabled,
|
||
add the TARGET_TYPE=debug option:
|
||
|
||
make -f Basic.mk TARGET_TYPE=debug
|
||
|
||
The makefile doesn't support Guile integration. Use build_w32.bat
|
||
if you want to build with Guile support.
|
||
|
||
|
||
Running the test suite
|
||
----------------------
|
||
|
||
3. You will need an installation of Perl. Be sure to use a relatively
|
||
modern version: older versions will sometimes throw spurious errors.
|
||
|
||
To run the suite after building using GNU make, use:
|
||
|
||
make -f Basic.mk check
|
||
|
||
Alternatively if you'd like to run tests by hand, use:
|
||
|
||
cd tests
|
||
.\run_make_tests.bat -make <path-to-make>
|
||
|
||
I've found <path-to-make> seems to want forward-slashes in the path.
|
||
For example if building with .\build_w32.bat non-debug, use:
|
||
|
||
cd tests
|
||
.\run_make_tests.bat -make ../WinRel/gnumake.exe
|
||
|
||
I've tested this with the MSYS2 shell and POSIX tools installation
|
||
that you get by installing Git for Windows.
|
||
|
||
|
||
|
||
-------------------
|
||
-- Notes/Caveats --
|
||
-------------------
|
||
|
||
GNU make on Windows 32-bit platforms:
|
||
|
||
This version of make is ported natively to Windows32 platforms
|
||
(Windows NT 3.51, Windows NT 4.0, Windows 2000, Windows XP,
|
||
Windows 95, and Windows 98). It does not rely on any 3rd party
|
||
software or add-on packages for building. The only thing
|
||
needed is a Windows compiler. Two compilers supported
|
||
officially are the MinGW port of GNU GCC, and the various
|
||
versions of the Microsoft C compiler.
|
||
|
||
Do not confuse this port of GNU make with other Windows32 projects
|
||
which provide a GNU make binary. These are separate projects
|
||
and are not connected to this port effort.
|
||
|
||
GNU make and sh.exe:
|
||
|
||
This port prefers if you have a working sh.exe somewhere on
|
||
your system. If you don't have sh.exe, the port falls back to
|
||
MSDOS mode for launching programs (via a batch file). The
|
||
MSDOS mode style execution has not been tested that carefully
|
||
though (The author uses GNU bash as sh.exe).
|
||
|
||
There are very few true ports of Bourne shell for NT right now.
|
||
There is a version of GNU bash available from Cygnus "Cygwin"
|
||
porting effort (http://www.cygwin.com/).
|
||
Other possibilities are the MKS version of sh.exe, or building
|
||
your own with a package like NutCracker (DataFocus) or Portage
|
||
(Consensys). Also MinGW includes sh (http://mingw.org/).
|
||
|
||
GNU make and brain-dead shells (BATCH_MODE_ONLY_SHELL):
|
||
|
||
Some versions of Bourne shell do not behave well when invoked
|
||
as 'sh -c' from CreateProcess(). The main problem is they seem
|
||
to have a hard time handling quoted strings correctly. This can
|
||
be circumvented by writing commands to be executed to a batch
|
||
file and then executing the command by calling 'sh file'.
|
||
|
||
To work around this difficulty, this version of make supports
|
||
a batch mode. When BATCH_MODE_ONLY_SHELL is defined at compile
|
||
time, make forces all command lines to be executed via script
|
||
files instead of by command line. In this mode you must have a
|
||
working sh.exe in order to use parallel builds (-j).
|
||
|
||
A native Windows32 system with no Bourne shell will also run
|
||
in batch mode. All command lines will be put into batch files
|
||
and executed via $(COMSPEC) (%COMSPEC%). However, parallel
|
||
builds ARE supported with Windows shells (cmd.exe and
|
||
command.com). See the next section about some peculiarities
|
||
of parallel builds on Windows.
|
||
|
||
Support for parallel builds
|
||
|
||
Parallel builds (-jN) are supported in this port. The number of
|
||
concurrent processes has a hard limit of 4095.
|
||
|
||
GNU make and Cygnus GNU Windows32 tools:
|
||
|
||
Good news! Make now has native support for Cygwin sh. To enable,
|
||
define the HAVE_CYGWIN_SHELL in config.h and rebuild make
|
||
from scratch. This version of make tested with B20.1 of Cygwin.
|
||
Do not define BATCH_MODE_ONLY_SHELL if you use HAVE_CYGWIN_SHELL.
|
||
|
||
GNU make and the MKS shell:
|
||
|
||
There is now semi-official support for the MKS shell. To turn this
|
||
support on, define HAVE_MKS_SHELL in the config.h.W32 before you
|
||
build make. Do not define BATCH_MODE_ONLY_SHELL if you turn
|
||
on HAVE_MKS_SHELL.
|
||
|
||
GNU make handling of drive letters in pathnames (PATH, vpath, VPATH):
|
||
|
||
There is a caveat that should be noted with respect to handling
|
||
single character pathnames on Windows systems. When colon is
|
||
used in PATH variables, make tries to be smart about knowing when
|
||
you are using colon as a separator versus colon as a drive
|
||
letter. Unfortunately, something as simple as the string 'x:/'
|
||
could be interpreted 2 ways: (x and /) or (x:/).
|
||
|
||
Make chooses to interpret a letter plus colon (e.g. x:/) as a
|
||
drive letter pathname. If it is necessary to use single
|
||
character directories in paths (VPATH, vpath, Path, PATH), the
|
||
user must do one of two things:
|
||
|
||
a. Use semicolon as the separator to disambiguate colon. For
|
||
example use 'x;/' if you want to say 'x' and '/' are
|
||
separate components.
|
||
|
||
b. Qualify the directory name so that there is more than
|
||
one character in the path(s) used. For example, none
|
||
of these settings are ambiguous:
|
||
|
||
./x:./y
|
||
/some/path/x:/some/path/y
|
||
x:/some/path/x:x:/some/path/y
|
||
|
||
Please note that you are free to mix colon and semi-colon in the
|
||
specification of paths. Make is able to figure out the intended
|
||
result and convert the paths internally to the format needed
|
||
when interacting with the operating system, providing the path
|
||
is not within quotes, e.g. "x:/test/test.c".
|
||
|
||
You are encouraged to use colon as the separator character.
|
||
This should ease the pain of deciding how to handle various path
|
||
problems which exist between platforms. If colon is used on
|
||
both Unix and Windows systems, then no ifdef'ing will be
|
||
necessary in the makefile source.
|
||
|
||
Pathnames and white space:
|
||
|
||
Unlike Unix, Windows 95/NT systems encourage pathnames which
|
||
contain white space (e.g. C:\Program Files\). These sorts of
|
||
pathnames are valid on Unix too, but are never encouraged.
|
||
There is at least one place in make (VPATH/vpath handling) where
|
||
paths containing white space will simply not work. There may be
|
||
others too. I chose to not try and port make in such a way so
|
||
that these sorts of paths could be handled. I offer these
|
||
suggestions as workarounds:
|
||
|
||
1. Use 8.3 notation. i.e. "x:/long~1/", which is actually
|
||
"x:\longpathtest". Type "dir /x" to view these filenames
|
||
within the cmd.exe shell.
|
||
2. Rename the directory so it does not contain white space.
|
||
|
||
If you are unhappy with this choice, this is free software
|
||
and you are free to take a crack at making this work. The code
|
||
in w32/pathstuff.c and vpath.c would be the places to start.
|
||
|
||
Pathnames and Case insensitivity:
|
||
|
||
Unlike Unix, Windows 95/NT systems are case insensitive but case
|
||
preserving. For example if you tell the file system to create a
|
||
file named "Target", it will preserve the case. Subsequent access to
|
||
the file with other case permutations will succeed (i.e. opening a
|
||
file named "target" or "TARGET" will open the file "Target").
|
||
|
||
By default, GNU make retains its case sensitivity when comparing
|
||
target names and existing files or directories. It can be
|
||
configured, however, into a case preserving and case insensitive
|
||
mode by adding a define for HAVE_CASE_INSENSITIVE_FS to
|
||
config.h.W32.
|
||
|
||
For example, the following makefile will create a file named
|
||
Target in the directory subdir which will subsequently be used
|
||
to satisfy the dependency of SUBDIR/DepTarget on SubDir/TARGET.
|
||
Without HAVE_CASE_INSENSITIVE_FS configured, the dependency link
|
||
will not be made:
|
||
|
||
subdir/Target:
|
||
touch $@
|
||
|
||
SUBDIR/DepTarget: SubDir/TARGET
|
||
cp $^ $@
|
||
|
||
Reliance on this behavior also eliminates the ability of GNU make
|
||
to use case in comparison of matching rules. For example, it is
|
||
not possible to set up a C++ rule using %.C that is different
|
||
than a C rule using %.c. GNU make will consider these to be the
|
||
same rule and will issue a warning.
|
||
|
||
SAMBA/NTFS/VFAT:
|
||
|
||
I have not had any success building the debug version of this
|
||
package using SAMBA as my file server. The reason seems to be
|
||
related to the way VC++ 4.0 changes the case name of the pdb
|
||
filename it is passed on the command line. It seems to change
|
||
the name always to to lower case. I contend that the VC++
|
||
compiler should not change the casename of files that are passed
|
||
as arguments on the command line. I don't think this was a
|
||
problem in MSVC 2.x, but I know it is a problem in MSVC 4.x.
|
||
|
||
The package builds fine on VFAT and NTFS filesystems.
|
||
|
||
Most all of the development I have done to date has been using
|
||
NTFS and long file names. I have not done any considerable work
|
||
under VFAT. VFAT users may wish to be aware that this port of
|
||
make does respect case sensitivity.
|
||
|
||
FAT:
|
||
|
||
Version 3.76 added support for FAT filesystems. Make works
|
||
around some difficulties with stat'ing of files and caching of
|
||
filenames and directories internally.
|
||
|
||
Bug reports:
|
||
|
||
Please submit bugs via the normal bug reporting mechanism which
|
||
is described in the GNU make manual and the base README.
|
||
|
||
-------------------------------------------------------------------------------
|
||
Copyright (C) 1996-2017 Free Software Foundation, Inc.
|
||
This file is part of GNU Make.
|
||
|
||
GNU Make is free software; you can redistribute it and/or modify it under the
|
||
terms of the GNU General Public License as published by the Free Software
|
||
Foundation; either version 3 of the License, or (at your option) any later
|
||
version.
|
||
|
||
GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
|
||
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
|
||
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
|
||
|
||
You should have received a copy of the GNU General Public License along with
|
||
this program. If not, see <http://www.gnu.org/licenses/>.
|