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.