fpcmake(5)

NAME

Makefile.fpc - Configuration file for fpcmake.

SYNOPSIS

Makefile.fpc is a configuration file for the fpcmake  command.  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 sections are

recognized (in alphabetical order):

clean Specifies rules for cleaning the directory of units

and programs. The following entries are recognized:

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 recognized:

dirprefix

the directory below wchich all installs are

done. This corresponds to the --prefix argument to GNU configure

It is used for the installation of programs and units. By de

fault, this is on linux, and on all other platforms.

dirbase

The directory that is used as the base di

rectory for the installation of units. Default this is dirprefix

appended with /lib/fpc/FPC_VERSION for linux or simply the

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 keyword

packages with the OS you are compiling for, e.g. linuxpackages

if you want the makefile to use the listed packages on linux on

ly.

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 de

fine additional rules and configuration variables.

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 vari

ables 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 sec

tion will be written to the makefile. By default, all sections

are written.

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.

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 exam

ples. Do not specify an extension, the extension will be append

ed.

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 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 international

ization 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 in

serted 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 de

fault.

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 de

fault.

toolupx

Use the upx executable packer True by de

fault.

tooldate

use the date date displaying tool. True by

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 compiled 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

fpcmake(5)