[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

14. Makefile Targets

This is the default target. Depending on what your build/host/target configuration is, it coordinates all the things that need to be built.

Produce info-formatted documentation. Also, make dvi is available for DVI-formatted documentation, and make generated-manpages to generate man pages.

Delete the files made while building the compiler.

That, and all the other files built by make all.

That, and all the files created by configure.

That, and any temporary or intermediate files, like emacs backup files.

Distclean plus any file that can be generated from other files. Note that additional tools may be required beyond what is normally needed to build gcc.

Installs gcc.

Deletes installed files.

Run the testsuite. This creates a `testsuite' subdirectory that has various `.sum' and `.log' files containing the results of the testing. You can run subsets with, for example, make check-gcc. You can specify specific tests by setting RUNTESTFLAGS to be the name of the `.exp' file, optionally followed by (for some tests) an equals and a file wildcard, like:

make check-gcc RUNTESTFLAGS="execute.exp=19980413-*"

Note that running the testsuite may require additional tools be installed, such as TCL or dejagnu.

Builds gcc three times--once with the native compiler, once with the native-built compiler it just built, and once with the compiler it built the second time. In theory, the last two should produce the same results, which make compare can check. Each step of this process is called a "stage", and the results of each stage N (N = 1...3) are copied to a subdirectory `stageN/'.

Like bootstrap, except that the various stages are removed once they're no longer needed. This saves disk space.

Once bootstrapped, this incrementally rebuilds each of the three stages, one at a time. It does this by "bubbling" the stages up from their subdirectories, rebuilding them, and copying them back to their subdirectories. This will allow you to, for example, quickly rebuild a bootstrapped compiler after changing the sources, without having to do a full bootstrap.

Rebuilds the most recently built stage. Since each stage requires special invocation, using this target means you don't have to keep track of which stage you're on or what invocation that stage needs.

Removed everything (make clean) and rebuilds (make bootstrap).

stageN (N = 1...4)
For each stage, moves the appropriate files to the `stageN' subdirectory.

unstageN (N = 1...4)
Undoes the corresponding stageN.

restageN (N = 1...4)
Undoes the corresponding stageN and rebuilds it with the appropriate flags.

Compares the results of stages 2 and 3. This ensures that the compiler is running properly, since it should produce the same object files regardless of how it itself was compiled.

[ < ] [ > ]   [ << ] [ Up ] [ >> ]         [Top] [Contents] [Index] [ ? ]

This document was generated by Vincent Chung on June, 26 2001 using texi2html