VirtualBox

source: kBuild/trunk/src/kmk/README.template@ 3387

Last change on this file since 3387 was 3140, checked in by bird, 6 years ago

kmk: Merged in changes from GNU make 4.2.1 (2e55f5e4abdc0e38c1d64be703b446695e70b3b6 / https://git.savannah.gnu.org/git/make.git).

File size: 6.6 KB
Line 
1This directory contains the %VERSION% release of GNU Make.
2
3See the file NEWS for the user-visible changes from previous releases.
4In addition, there have been bugs fixed.
5
6Please check the system-specific notes below for any caveats related to
7your operating system.
8
9For general building and installation instructions, see the file INSTALL.
10
11If you need to build GNU Make and have no other 'make' program to use,
12you can use the shell script 'build.sh' instead. To do this, first run
13'configure' as described in INSTALL. Then, instead of typing 'make' to
14build the program, type 'sh build.sh'. This should compile the program
15in the current directory. Then you will have a Make program that you can
16use for './make install', or whatever else.
17
18Some systems' Make programs are broken and cannot process the Makefile for
19GNU Make. If you get errors from your system's Make when building GNU
20Make, try using 'build.sh' instead.
21
22
23GNU Make is free software. See the file COPYING for copying conditions.
24GNU Make is copyright by the Free Software Foundation. Copyright notices
25condense sequential years into a range; e.g. "1987-1994" means all years
26from 1987 to 1994 inclusive.
27
28Downloading
29-----------
30
31GNU Make can be obtained in many different ways. See a description here:
32
33 http://www.gnu.org/software/software.html
34
35
36Documentation
37-------------
38
39GNU make is fully documented in the GNU Make manual, which is contained
40in this distribution as the file make.texinfo. You can also find
41on-line and preformatted (PostScript and DVI) versions at the FSF's web
42site. There is information there about ordering hardcopy documentation.
43
44 http://www.gnu.org/
45 http://www.gnu.org/doc/doc.html
46 http://www.gnu.org/manual/manual.html
47
48
49Development
50-----------
51
52GNU Make development is hosted by Savannah, the FSF's online development
53management tool. Savannah is here:
54
55 http://savannah.gnu.org
56
57And the GNU Make development page is here:
58
59 http://savannah.gnu.org/projects/make/
60
61You can find most information concerning the development of GNU Make at
62this site.
63
64
65Bug Reporting
66-------------
67
68You can send GNU make bug reports to <bug-make@gnu.org>. Please see the
69section of the GNU make manual entitled 'Problems and Bugs' for
70information on submitting useful and complete bug reports.
71
72You can also use the online bug tracking system in the Savannah GNU Make
73project to submit new problem reports or search for existing ones:
74
75 http://savannah.gnu.org/bugs/?group=make
76
77If you need help using GNU make, try these forums:
78
79 help-make@gnu.org
80 help-utils@gnu.org
81 news:gnu.utils.help
82 news:gnu.utils.bug
83
84
85Git Access
86----------
87
88The GNU make source repository is available via Git from the
89GNU Savannah Git server; look here for details:
90
91 http://savannah.gnu.org/git/?group=make
92
93Please note: you won't be able to build GNU make from Git without
94installing appropriate maintainer's tools, such as GNU m4, automake,
95autoconf, Perl, GNU make, and GCC. See the README.git file for hints on
96how to build GNU make once these tools are available. We make no
97guarantees about the contents or quality of the latest code in the Git
98repository: it is not unheard of for code that is known to be broken to
99be checked in. Use at your own risk.
100
101
102System-specific Notes
103---------------------
104
105It has been reported that the XLC 1.2 compiler on AIX 3.2 is buggy such
106that if you compile make with 'cc -O' on AIX 3.2, it will not work
107correctly. It is said that using 'cc' without '-O' does work.
108
109The standard /bin/sh on SunOS 4.1.3_U1 and 4.1.4 is broken and cannot be
110used to configure GNU make. Please install a different shell such as
111bash or pdksh in order to run "configure". See this message for more
112information:
113 http://mail.gnu.org/archive/html/bug-autoconf/2003-10/msg00190.html
114
115One area that is often a problem in configuration and porting is the code
116to check the system's current load average. To make it easier to test and
117debug this code, you can do 'make check-loadavg' to see if it works
118properly on your system. (You must run 'configure' beforehand, but you
119need not build Make itself to run this test.)
120
121Another potential source of porting problems is the support for large
122files (LFS) in configure for those operating systems that provide it.
123Please report any bugs that you find in this area. If you run into
124difficulties, then as a workaround you should be able to disable LFS by
125adding the '--disable-largefile' option to the 'configure' script.
126
127On systems that support micro- and nano-second timestamp values and
128where stat(2) provides this information, GNU make will use it when
129comparing timestamps to get the most accurate possible result. However,
130note that many current implementations of tools that *set* timestamps do
131not preserve micro- or nano-second granularity. This means that "cp -p"
132and other similar tools (tar, etc.) may not exactly duplicate timestamps
133with micro- and nano-second granularity on some systems. If your build
134system contains rules that depend on proper behavior of tools like "cp
135-p", you should consider using the .LOW_RESOLUTION_TIME pseudo-target to
136force make to treat them properly. See the manual for details.
137
138
139Ports
140-----
141
142 - See README.customs for details on integrating GNU make with the
143 Customs distributed build environment from the Pmake distribution.
144
145 - See README.VMS for details about GNU Make on OpenVMS.
146
147 - See README.Amiga for details about GNU Make on AmigaDOS.
148
149 - See README.W32 for details about GNU Make on Windows NT, 95, or 98.
150
151 - See README.DOS for compilation instructions on MS-DOS and MS-Windows
152 using DJGPP tools.
153
154 A precompiled binary of the MSDOS port of GNU Make is available as part
155 of DJGPP; see the WWW page http://www.delorie.com/djgpp/ for more
156 information.
157
158Please note there are two _separate_ ports of GNU make for Microsoft
159systems: a native Windows tool built with (for example) MSVC or Cygwin,
160and a DOS-based tool built with DJGPP. Please be sure you are looking
161at the right README!
162
163
164
165-------------------------------------------------------------------------------
166Copyright (C) 1988-2016 Free Software Foundation, Inc.
167This file is part of GNU Make.
168
169GNU Make is free software; you can redistribute it and/or modify it under the
170terms of the GNU General Public License as published by the Free Software
171Foundation; either version 3 of the License, or (at your option) any later
172version.
173
174GNU Make is distributed in the hope that it will be useful, but WITHOUT ANY
175WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
176A PARTICULAR PURPOSE. See the GNU General Public License for more details.
177
178You should have received a copy of the GNU General Public License along with
179this program. If not, see <http://www.gnu.org/licenses/>.
Note: See TracBrowser for help on using the repository browser.

© 2023 Oracle
ContactPrivacy policyTerms of Use