Comeau C/C++ 4.x
User-Documentation

  1. Command Line Driver Program

This document describes the interface to the command line driver. Additional options for recent updates of Comeau C/C++ can be found at http://www.comeaucomputing.com/features.html. The command line driver is invoked by a command of the form

    como [options] ifile
to compile the single input file ifile. Various file name suffixes are allowed on input files including .c, .C, .cc, .cpp, .CPP, .cxx, and .CXX. On a limited numer of platforms, some other suffixes might be allowed. And of course, object file or library extensions such as .o, .obj, .OBJ, .a, .lib or .LIB are ok, and usually follow the naming conventions for the respective platform being used. On a limited number of platforms, if - (hyphen) is specified for ifile, stdin will be used as the input file.

Command line options may be specified using either single character option codes (e.g., -o) or keyword options (e.g., --output), depending upon the option type. A single character option specification consists of a hyphen followed by one or more option characters (e.g., -Ab). If an option requires an argument, the argument may immediately follow the option letter, or may be separated from the option letter by white space. A keyword option specification consists of two hyphens followed by the option keyword (e.g., --strict). If an option requires an argument, the argument may be separated from the keyword by white space, or the keyword may be immediately followed by =option. When the second form is used there may not be any white space on either side of the equal sign.

Note: the MS-Windows port may not work this way in all cases, nor may it support all options and behavior discussed below. For instance, with Comeau C/C++ for MS-Windows there must be an equal sign where some of the options below allow spaces, and furthermore, there can be no spaces before or after the equal sign. Check out the "Windows specific" page for more details. Information on using STLFilt with Comeau C++ on MS-Windows can also be found at the end of that page.

A list of files may appear for ifile. If a list of files is specified, options that specify a compilation output file (--output, --list, and --xref) may not be used, and the name of each source file is usually written to stderr as the compilation of that file begins. Note: This capability is not the default, and would need to be activated under a custom porting arrangement.

When one of the preprocessing-only modes is specified (see below), the --output option can be used to specify the preprocessing output file. If --output is not specified, preprocessing output is written to stdout