Every preprocessor can be called as a separate application, without the ACUCOBOL-GT compiler, by a command line of one of the following forms (the second example is used with a preprocessor written in ACUCOBOL-GT):
preproc-1 -placePo output-file [options] input-file run-time preproc-2.ACU -placePo output-file [options] input-file
These command lines are very similar to the one used with the -Pg option, but there are some important differences:
For diagnostic purposes, a preprocessor also accepts either of the following two options:
|-help||do not preprocess; show command-line help on standard output device|
|-v||do not preprocess; show preprocessor version information on standard output device|
When either of these options is used, the input and output files need not be specified.
Some preprocessors may allow other combinations of options and files when called without the compiler.
The input and output files should be files, not devices, because the preprocessor may not read or write them in strictly sequential order.
A preprocessor returns an exit value 0 (zero) if the preprocessing was successful and the value 1 (one) if there were errors.