FPCMake
FPCMAKE - Free Pascal Makefile generator
What follows below is the man page of fpcmake and the description of the
configuration file. If you have installed the man pages then you can view
them with the
man command.
fpcmake(1) Free Pascal Makefile constructor fpcmake(1)
NAME
fpcmake - The Free Pascal makefile constuctor program.
SYNOPSIS
fpcmake [filename [filename [filename]]]
DESCRIPTION
fpcmake reads a Makefile.fpc and converts it to a Makefile
suitable for reading by GNU make to compile your projects.
It is similar in functionality to GNU autoconf or Imake
for making X projects.
USAGE
fpcmake accepts filenames of makefile description files as
it's command-line arguments. For each of these files it
will create a Makefile in the same directory where the
file is located, overwriting any other existing file.
If no options are given, it just attempts to read the file
Makefile.fpc in the current directory and tries to con-
struct a Makefile from it. any previously existing Make-
file will be erased. See fpcmake(5) for a description of
the format of the Makefile.fpc file.
SEE ALSO
fpcmake(5) ppc386(1) make(1)
FreePascal 12 Dec 1999 1
fpcmake(5) Free Pascal Makefile.fpc format fpcmake(5)
NAME
Makefile.fpc - Configuration file for fpcmake.
SYNOPSIS
Makefile.fpc is a configuration file for the fpcmake com-
mand. Starting from this file a Makefile is created to
compile Free Pascal units and programs.
DESCRIPTION
Makefile.fpc is a plain ASCII file that contains a number
of sections as in a Windows ini file. The following sec-
tions are recognized (in alphabetical order):
clean Specifies rules for cleaning the directory of units
and programs. The following entries are recog-
nized:
units names of all units that should be removed
when cleaning. Don't specify extensions, the
makefile will append these by itself.
files names of files that should be removed. Spec-
ify full filenames.
defaults
The defaults section contains some default set-
tings. The following keywords are recognized:
dirs
info
install
Contains instructions for installation of your
units and programs. The following keywods are rec-
ognized:
dirprefix
the directory below wchich all installs are
done. This corresponds to the --prefix argu-
ment to GNU configure It is used for the
installation of programs and units. By
default, this is on linux, and on all other
platforms.
dirbase
The directory that is used as the base
directory for the installation of units.
Default this is dirprefix appended with
/lib/fpc/FPC VERSION for linux or simply the
FreePascal 12 Dec 1999 1
fpcmake(5) Free Pascal Makefile.fpc format fpcmake(5)
dirprefix on other platforms.
Units will be installed in the subdirectory
units/$(OS TARGET) of the dirbase entry.
libs This section specifies what units should be merged
into a library, and what external libraries are
needed. It can contain the following keywords:
libname
the name of the library that should be cre-
ated.
libunits
a comma-separated list of units that should
be moved into one library.
needgcclib
a boolean value that specifies whether the
gcc library is needed. This will make sure
that the path to the GCC library is inserted
in the library search path.
needotherlib
a boolean value that tells the makefile that
other library directories will be needed.
packages
Which packages must be used. This section can con-
tain the following keywords:
packages
A comma-separated list of packages that are
needed to compile the targets. Valid for
all platforms. In order to differentiate
between platforms, you can prepend the key-
word packages with the OS you are compiling
for, e.g. linuxpackages if you want the
makefile to use the listed packages on linux
only.
fcl This is a boolean value (0 or 1) that indi-
cates whether the FCL is used.
rtl This is a boolean value (0 or 1) that indi-
cates whether the RTL should be recompiled.
postsettings
Anything that is in this section will be inserted
as-is in the makefile after the makefile rules that
are generated by fpcmake, but before the general
configuration rules. can define additional rules
and configuration variables.
FreePascal 12 Dec 1999 2
fpcmake(5) Free Pascal Makefile.fpc format fpcmake(5)
presettings
Anything that is in this section will be inserted
as-is in the makefile before the makefile target
rules that are generated by fpcmake. This means
that you cannot use any variables that are normally
defined by
rules In this section you can insert dependency rules and
any other targets you wish to have. Do not insert
'default rules' here.
sections
Here you can specify which 'rule sections' should
be included in the Makefile. The sections consist
of a series of boolean keywords; each keyword
decies whether a particular section will be written
to the makefile. By default, all sections are writ-
ten.
You can have the following boolean keywords in this
section.
none If this is set to true, then no sections are
written.
units If set to false , fpcmake omits the rules
for compiling units.
exes If set to false , fpcmake omits the rules
for compiling executables.
loaders
If set to false , fpcmake omits the rules
for assembling assembler files.
examples
If set to false , fpcmake omits the rules
for compiling examples.
package
If set to false , fpcmake omits the rules
for making packages.
compile
If set to false , fpcmake omits the generic
rules for compiling pascal files.
depend If set to false , fpcmake omits the depen-
dency rules.
install
If set to false , fpcmake omits the rules
for installing everything.
FreePascal 12 Dec 1999 3
fpcmake(5) Free Pascal Makefile.fpc format fpcmake(5)
sourceinstall
If set to false , fpcmake omits the rules
for installing the sources.
zipinstall
If set to false , fpcmake omits the rules
for installing archives.
clean If set to false , fpcmake omits the rules
for cleaning the directories.
libs If set to false , fpcmake omits the rules
for making libraries.
command
If set to false , fpcmake omits the rules
for composing the command-line based on the
various variables.
exts If set to false , fpcmake omits the rules
for making libraries.
dirs If set to false , fpcmake omits the rules
for running make in subdirectories..
tools If set to false , fpcmake omits the rules
for running some tools as the erchiver, UPX
and zip.
info If set to false , fpcmake omits the rules
for generating information.
targets
In this section you can define the various targets.
The following keywords can be used there:
dirs A space separated list of directories where
make should also be run.
examples
A space separated list of example programs
that need to be compiled when the user asks
to compile the examples. Do not specify an
extension, the extension will be appended.
loaders
A space separated list of names of assembler
files that must be assembled. Don't specify
the extension, the extension will be
appended.
programs
A space separated list of program names that
need to be compiled. Do not specify an
FreePascal 12 Dec 1999 4
fpcmake(5) Free Pascal Makefile.fpc format fpcmake(5)
extension, the extension will be appended.
rst a list of rst files that needs to be con-
verted to .po files for use with GNU gettext
and internationalization routines.
units A space separated list of unit names that
need to be compiled. Do not specify an
extension, just the name of the unit as it
would appear un a uses clause is sufficient.
tools In this section you can specify which tools are
needed. Definitions to use each of the listed tools
will be inserted in the makefile, depending on the
setting in this section.
Each keyword is a boolean keyword; you can switch
the use of a tool on or off with it.
The following keywords are recognised:
toolppdep
Use ppdep the dependency tool. True by
default.
toolppumove
Use ppumove the Free Pascal unit mover.
True by default.
toolppufiles
Use the ppufile tool to determine dependen-
cies of unit files. True by default.
toolsed
Use sed the stream line editor. False by
default.
tooldata2inc
use the data2inc tool to create include
files from data files. False by default.
tooldiff
Use the GNU diff tool. False by default.
toolcmp
Use the cmp file comparer tool False by
default.
toolupx
Use the upx executable packer True by
default.
tooldate
use the date date displaying tool. True by
FreePascal 12 Dec 1999 5
fpcmake(5) Free Pascal Makefile.fpc format fpcmake(5)
default.
toolzip
Use the zip file archiver. This is used by
the zip targets. True by default.
zip This section can be used to make zip files from the
compiled units and programs. By default all com-
piled units are zipped. The zip behaviour can be
influencd with the presettings and postsettings
sections.
The following keywords can be used in this unit:
zipname
this file is the name of the zip file that
will be produced.
ziptarget
is the name of a makefile target that will
be executed before the zip is made. By
default this is the install target.
SEE ALSO
fpcmake(1) ppc386(1) make(1)
FreePascal 12 Dec 1999 6
