5.2 Using the conguration le

Using the conguration le fpc.cfg is an alternative to command line options. When a conguration le is found, it is read, and the lines in it are treated like you typed them on the command line. They are treated before the options that you type on the command line.

You can specify comments in the conguration le with the # sign. Everything from the # on will be ignored.

The algorithm to determine which le is used as a conguration le is decribed in 3.1.5 on page 67.

When the compiler has nished reading the conguration le, it continues to treat the command line options.

One of the command-line options allows you to specify a second conguration le: Specifying @foo on the command line will open le foo, and read further options from there. When the compiler has nished reading this le, it continues to process the command line.

The conguration le allows some kind of preprocessing. It understands the following directives, which you should place on the rst column of a line :

#IFDEF
#IFNDEF
#ELSE
#ENDIF
#DEFINE
#UNDEF
#WRITE
#INCLUDE
#SECTION

They work the same way as their f$...g counterparts in Pascal. All the default denes used to compile source code are also dened while processing the conguration le. For example, if the target compiler is an intel 80x86 compatile linux platform, both cpu86 and linux will be dened while interpreting the conguration le. For the possible default denes when compiling, consult Appendix G of the Programmers guide.

What follows is a description of the dierent directives.


  5.2.1 #IFDEF
  5.2.2 #IFNDEF
  5.2.3 #ELSE
  5.2.4 #ENDIF
  5.2.5 #DEFINE
  5.2.6 #UNDEF
  5.2.7 #WRITE
  5.2.8 #INCLUDE
  5.2.9 #SECTION