E.2 Functionality

fpcmake generates a makefile, suitable for GNU make, which can be used to

  1. Compile units and programs, fit for testing or for final distribution.
  2. Compile example units and programs separately.
  3. Install compiled units and programs in standard locations.
  4. Make archives for distribution of the generated programs and units.
  5. Clean up after compilation and tests.

fpcmake knows how the Free Pascal compiler operates, which command line options it uses, how it searches for files and so on; It uses this knowledge to construct sensible command lines.

Specifically, it constructs the following targets in the final makefile:

all
Makes all units and programs.
debug
Makes all units and programs with debug info included.
smart
Makes all units and programs in smartlinked version.
examples
Makes all example units and programs.
shared
Makes all units and programs in shared library version (currently disabled).
install
Installs all units and programs.
sourceinstall
Installs the sources to the Free Pascal source tree.
exampleinstall
Installs any example programs and units.
distinstall
Installs all units and programs, as well as example units and programs.
zipinstall
Makes an archive of the programs and units which can be used to install them on another location, i.e. it makes an archive that can be used to distribute the units and programs.
zipsourceinstall
Makes an archive of the program and unit sources which can be used to distribute the sources.
zipexampleinstall
Makes an archive of the example programs and units which can be used to install them on another location, i.e. it makes an archive that can be used to distribute the example units and programs.
zipdistinstall
Makes an archive of both the normal as well as the example programs and units. This archive can be used to install them on another location, i.e. it makes an archive that can be used to distribute.
clean
Cleans all files that are produced by a compilation.
distclean
Cleans all files that are produced by a compilation, as well as any archives, examples or files left by examples.
cleanall
Same as clean.
info
Produces some information on the screen about used programs, file and directory locations, where things will go when installing and so on.

Each of these targets can be highly configured, or even totally overridden by the configuration file Makefile.fpc.