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.