This is the documentation of version 1.18. You may want the documentation of the stable version (2.0) or of the well tested 2.1 development snapshot or our homepage.

Incompatibliities between Make and Makepp

makepp was designed to be as close as possible to GNU make. However, because of the difference in philosophy, some of GNU make's features cannot be supported; others have not been implemented because I haven't had time. Also, in order to emulate GNU make's behavior precisely, you may in some cases have to add additional command line options to the makepp command line, as noted below. Most of the differences from GNU make are quite technical and only rarely cause problems.

Makepp will give warning messages for many things which the traditional unix make accepts without flinching. This is because there are better ways to do them with makepp. If these warnings annoy you, you can turn them off with the --nowarn command line option.

Incompatibilities

Incompatibilities without the --percent-subdirs option

By default, % in a pattern rule does not match directories. Thus %.c matches only .c files in the current directory. If you want it to match files in subdirectories too, then add the --percent-subdirs option to the command line. You can also enable this in your makefile by the assignment percent_subdirs=1.

Incompatibilities without the -m option

By default, makepp will attempt to rebuild all targets if any of the dependencies have changed since the last build, or if the command has changed. This is normally what you want. Sometimes, however, you don't want the target to be rebuilt if it has been modified apart from the control of makepp (e.g., by editing it, or by running a program manually to make the file). You can force makepp to use the traditional make algorithm, which only rebuilds if any of the targets are newer than the dependencies, by adding the option -m target_newer to the command line.

As a special exception, any targets which are built while rebuilding the makefile are automatically checked using the target_newer method in order to avoid problems with configure procedures.

Incompatibilities without the --traditional-recursion option

Recursive invocations of make are often considered to be an unsafe practice (see the section on recursive make in the discussion of deprecated idioms), but they are extremely common in existing makefiles. Makepp supports recursive make for backward compatibility; for new makefiles, it is much better to use the load_makefile statement, or makepp's implicit makefile loading mechanism.

Sometimes recursive make invocations set variables on the command line:

target: dependencies
	cd subdir && $(MAKE) VAR=val VAR2=val2 some-other-target

If you do this, you may have to add the --noimplicit-load option to the command line to avoid conflicts between what the parent process and the child process think the build rules are.

In order to be able to use repositories for variant builds, and to help make recursive invocations of make safter, makepp normally does not actually invoke itself recursively even if you tell it to. Instead, a subprocess communicates with the parent process, and the actual build is done by the parent process.

This works in most cases, but there are a few incompatibilities. (All of these incompatibilities are removed by adding the --traditional-recursive-make option to the command line.)

This may seem like a long list of restrictions, but many makefiles obey them. For example, as far as I know, all makefiles produced by automake follow these restrictions.

All of these restrictions go away if you add the --traditional-recursive-make option to the command line, but that has the following undesirable side effects:

Even with the --traditional-recursive-make option, there are a few remaining incompatibilities:

Incompatibilities without the --norc-substitution option

Rc-style substitution is the default way makepp performs variable substitution into text strings because it very rarely breaks legacy makefiles and is often useful in new makefiles. However, it does introduce occasional incompatibilities in the substitution of variables not surrounded by spaces. For example,

INCLUDE_PREFIX := -I/some/include/dir -I
INCLUDES := $(INCLUDE_PREFIX)/other/include/dir

will set INCLUDES to

-I/some/include/dir/other/include/dir -I/other/include/dir
if rc-style substitution is enabled, whereas GNU make would set it to
-I/some/include/dir -I/other/include/dir

There is also an incompatibility in the handling of whitespace in a variable:

null :=
T := -o $(null)		# T contains -o followed by one space.
OUTFILE = $(T)outfile

will set OUTFILE to -ooutfile if rc-style substitution is enabled, whereas GNU make would set it to -o outfile.

Both of these incompatibilities are removed by the --norc-substitution option. Note, however, that even with --norc-substitution, makepp still treats whitespace incompatibly in some situations:

T := -o # Don't delete this comment.

GNU make sets T to contain -o followed by a space, whereas makepp strips out the trailing space anyway. If you want the trailing space, you must specify --norc-substitution and also set T using the technique involving a dummy variable such as null, as shown above.

Command line incompatibilities

At present, you may not combine single character options into a single word. E.g., you may not say makepp -ejk 2 instead of makepp -e -j 2 -k.

Makepp supports a few of make's more useful command line options. The following, however, are not supported, and are ignored after a warning message is printed:

Some of these can be easily supported if anyone cares.

Note that the -q option at present actually does something different--it suppresses some of makepp's chatty informational messages.

The -m option also has a different function.


Table of contents | Next (bugs) | Previous (using/converting old makefiles)
Last modified: Wed May 16 10:00:56 PDT 2001