* Update the AUTHORS file.
[make.git] / README.template
blobc9a199dbd4e6a5b4ea7d4f6feb5204be6716f471
1 This directory contains the %VERSION% release of GNU Make.
2 All bugs reported for previous releases have been fixed.
3 Some bugs surely remain.
5 For general building and installation instructions, see the file INSTALL.
7 If you need to build GNU Make and have no other `make' program to use,
8 you can use the shell script `build.sh' instead.  To do this, first run
9 `configure' as described in INSTALL.  Then, instead of typing `make' to
10 build the program, type `sh build.sh'.  This should compile the program
11 in the current directory.  Then you will have a Make program that you can
12 use for `./make install', or whatever else.
14 Some systems' Make programs are broken and cannot process the Makefile for
15 GNU Make.  If you get errors from your system's Make when building GNU
16 Make, try using `build.sh' instead.
18 GNU make is fully documented in the GNU Make manual, which is contained
19 in this distribution as the file make.texinfo.  You can also find
20 on-line and preformatted (PostScript and DVI) versions at the FSF's web
21 site.  There is information there about ordering hardcopy documentation.
23   http://www.gnu.org/
24   http://www.gnu.org/doc/doc.html
25   http://www.gnu.org/manual/manual.html
27 Please send GNU make bug reports to bug-make@gnu.org.  Please see the
28 section of the manual entitles `Problems and Bugs' for information on
29 submitting bug reports.
31 If you need help using GNU make, try these forums:
33   help-make@gnu.org
34   help-utils@gnu.org
35   news:gnu.utils.help
36   news:gnu.utils.bug
38 Also:
40   - See README.customs for details on integrating GNU make with the
41     Customs distributed build environment from the Pmake distribution.
43   - See README.W32 for details about GNU Make on Windows NT or 95.
45   - See README.Amiga for details about GNU Make on AmigaDOS.
47   - See README.DOS for compilation instructions on MS-DOS and MS-Windows
48     using DJGPP tools.
50     A precompiled binary of the MSDOS port of GNU Make is available as part
51     of DJGPP; see the WWW page http://www.delorie.com/djgpp/ for more
52     information.
54 It has been reported that the XLC 1.2 compiler on AIX 3.2 is buggy such
55 that if you compile make with `cc -O' on AIX 3.2, it will not work correctly.
56 It is said that using `cc' without `-O' does work.
58 One area that is often a problem in configuration and porting is the code
59 to check the system's current load average.  To make it easier to test and
60 debug this code, you can do `make check-loadavg' to see if it works
61 properly on your system.  (You must run `configure' beforehand, but you
62 need not build Make itself to run this test.)
64 See the file NEWS for what has changed since previous releases.
66 GNU Make is fully documented in make.texinfo.  See the section entitled
67 `Problems and Bugs' for information on submitting bug reports.
69 GNU Make is free software.  See the file COPYING for copying conditions.