Changeset 1993 in kBuild for trunk/src/kmk/README.W32.template

Timestamp:

Oct 29, 2008 12:37:51 AM (16 years ago)

Author:

bird

Message:

Merged in current GNU Make code (CVS from 2008-10-28). Ref #55.

File:

• trunk/src/kmk/README.W32.template (modified) (8 diffs)

trunk/src/kmk/README.W32.template

@@ -2 +2 @@
 It has also been used on Windows 95/98/NT, and on OS/2.
 
-It builds natively with MSVC 2.x, 4.x, 5.x, 6.x, and 2003 as well as
-.NET 7.x and .NET 2003.
-
-It builds with the MinGW port of GCC 3.x (tested with GCC 3.4.2).
+It builds with the MinGW port of GCC (tested with GCC 3.4.2).
+
+It also builds with MSVC 2.x, 4.x, 5.x, 6.x, and 2003 as well as
+with .NET 7.x and .NET 2003.
 
 The Windows 32-bit port of GNU make is maintained jointly by various
@@ -28 +28 @@
 
  2. Open make_msvc_net2003.vcproj in MSVS71 or MSVC71 or any compatible IDE,
-    then build this project as usual.
+    then build this project as usual.  There's also a solution file for
+    Studio 2003.
 
 
@@ -69 +70 @@
 
         This version of make is ported natively to Windows32 platforms
-        (Windows NT 3.51, Windows NT 4.0, 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 version of Visual C++,
-        which is the predominant compiler used on 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
@@ -80 +83 @@
 GNU make and sh.exe:
 
-        This port prefers 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).
+        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.
@@ -109 +112 @@
         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%).  Note that parallel
-        builds (-j) require a working Bourne shell; they will not work
-        with COM.
+        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, with 2
+        limitations:
+
+          - The number of concurrent processes has a hard limit of 64,
+            due to the way this port implements waiting for its
+            subprocesses;
+
+          - The job server method (available when Make runs on Posix
+            platforms) is not supported, which means you must pass an
+            explicit -jN switch to sub-Make's in a recursive Makefile.
+            If a sub-Make does not receive an explicit -jN switch, it
+            will default to -j1, i.e. no parallelism in sub-Make's.
 
 GNU make and Cygnus GNU Windows32 tools:
@@ -172 +191 @@
         sh.exe.  Tests were performed on both Windows NT and Windows 95.
 
-Building GNU make on Windows NT and Windows 95/98 with Microsoft Visual C:
-
-        I did not provide a Visual C project file with this port as
-        the project file would not be considered freely distributable
-        (or so I think). It is easy enough to create one, though, if
-        you know how to use Visual C.
-
-        I build the program statically to avoid problems locating DLL's
-        on machines that may not have MSVC runtime installed. If you
-        prefer, you can change make to build with shared libraries by
-        changing /MT to /MD in the NMakefile (or in build_w32.bat).
-
-        The program has not been built for non-Intel architectures (yet).
-
-        I have not tried to build with any other compilers than MSVC. I
-        have heard that this is possible though so don't be afraid to
-        notify me of your successes!
-
 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 legal under Unix too, but are never encouraged.
+        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
@@ -274 +275 @@
 -------------------------------------------------------------------------------
 Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
-2006 Free Software Foundation, Inc.
+2006, 2007, 2008 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 2, or (at your option) any later version.
+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
@@ -286 +288 @@
 
 You should have received a copy of the GNU General Public License along with
-GNU Make; see the file COPYING.  If not, write to the Free Software
-Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+this program.  If not, see <http://www.gnu.org/licenses/>.