xref: /freebsd/contrib/bmake/README (revision f5463265955b829775bbb32e1fd0bc11dafc36ce)
1			       bmake
2			       *****
3
4This directory contains a port of the BSD make tool (from NetBSD).
5Since 1993 I have run it on AIX, BSDi, Darwin, FreeBSD, HP-UX, IRIX,
6Linux, Minix, OSF, Solaris, SunOS and even UTS.
7Others have run it on many more systems.
8
9Currently each release is tested on Darwin, NetBSD, FreeBSD and Linux.
10
11Since 2003 bmake switched to a date based version (first was 20030714)
12which generally represents the date it was last merged with NetBSD's
13make.  Since then, NetBSD's make is imported within a week of any
14*interesting* changes, so that bmake tracks it very closely.
15
16Building
17========
18
19The preferred way to bootstrap bmake is::
20
21	./bmake/boot-strap
22
23there are a number of args - most of which get passed to configure,
24eg.
25::
26
27	./bmake/boot-strap --prefix=/opt
28
29see the boot-strap script for details.
30
31For folk that hate to read anything, since 20121212 you can also use
32the GNU standard process of::
33
34	./configure; make; make install
35
36This will *not* work on Darwin or any other system with a case
37insensitive filesystem.  It depends on a generated ``makefile`` which
38is disabled by default on Darwin.
39
40To make much use of bmake you will need the bsd.*.mk macros or my
41portable *.mk macros which are included with bmake since 20121212
42and separately available from
43https://www.crufty.net/ftp/pub/sjg/mk.tar.gz
44both that and
45https://www.crufty.net/ftp/pub/sjg/bmake.tar.gz
46will be links to the latest versions.
47
48Porting
49=======
50
51If you encounter a system that bmake does not build or work on *out of
52the box*, I welcome patches.
53Even a report of unit tests which fail is appreciated.
54If you can provide access to a suitable machine - even better.
55
56More info can be found at https://www.crufty.net/help/sjg/bmake.htm
57
58--sjg <sjg@crufty.net>
59
60