13.3 C--.ini

-------------

The file c--.ini is used to define the default parameters of the

compiler.

The compiler currently supports a huge number of command-line

parameters. Their correct use allows you to obtain more compact code and

can make it much easier to debug a program. But since there are so many

parameters, it is tiring to collect them in the command line every time,

and there is always the chance of leaving something out. The c--.ini has

been added to avoid all these problems.

The command-line parameters are registered line by line in this file.

The syntax is the same as on the command line, but without the initial

backslash or minus sign. If the file is in the directory to which the

environment variable set c--=<path> points, or if this variable is not

defined, or is in the same directory as c--.exe, these parameters are

distributed to all the compiled programs. If c--.ini is located in the

current directory, the parameters are read only from this file and act only

for the current project.

Comments may be used. The semicolon ';' indicates the start of a

comment, and all successive characters to the end of the line are taken to

be comments.

Example of c--.ini:

r-

X

3 ;this is a comment

os

An ini file can have any name (but the file extension must be .ini).

The file name with extension must be passed to the compiler on the command

line. This file is loaded and processed automatically before loading the

file indicated in the command line.

An ini file can thus be used similar to a make file, to indicate the

name of the main compiled module, and all the options needed for its

compilation.

An alternative to c--.ini is to register the command-line parameters

directly at the beginning of the mail file of the compiled project, using

'pragma option'. On the one hand, this causes the project to be independent

of the compiler options, if the project is compiled on a different

computer. But on the other hand some adjustments are individual for each

computer (such as the location of libraries, names and location of the stub

files). It is your decision which variant to use, but they say, and I

agree, that it is best to use the golden mean - to write some of the

parameters in c--.ini and the others directly in the file to be compiled.