Print this page
Review from Robert, and nits


  52              the form -_name= and -_style= Where name and style are those
  53              passed to --primary and --shadow this allows certain flags to be
  54              passed only to certain classes of compiler.
  55 
  56              For historical reasons, the -_style= option is also translated
  57              such that a style of sun may use the flag -_cc= and a style of
  58              gnu may use the flag -_gcc=, and when the -C option is given and
  59              C++ is in use the style of sun may use the flag -_CC= and the
  60              style of gnu may use the flag -_g++=.
  61 
  62 SHADOW COMPILATION
  63      If --shadow compilers are specified cw will invoke shadow compiler, with
  64      the outputs modified (as well as any translation for compiler style) as
  65      follows:
  66 
  67      1.   If none of -c, -E, -P, or -S appears in the argument list (that is,
  68           linking is attempted), the shadow compilers will not be invoked.
  69           This is because the objects built with that compiler which would be
  70           linked have been previously discarded.
  71 
  72      2.   If an option of the form -o filename was provided, it will be
  73           replaced by two options of the form -o tempfile
  74 
  75      3.   If the option -o was not provided, -o tempfile will be added to the
  76           end of the argument list used to invoke the shadow compilers.
  77      When shadow compilation is in effect, cw writes to standard error each
  78      compiler's standard error output following its argument list.  Messages
  79      from the compilers will not be interleaved.  If cw is used to invoke the
  80      preprocessor and no output location is specified, cw will write to
  81      standard output the primary compiler's standard output, and the secondary
  82      compiler's standard output will be discarded.
  83 
  84      Because the Sun compilers write intermediate objects to fixed filenames
  85      in the current directory when instructed to compile and link multiple
  86      source files via a single command line, it would be unsafe to invoke more
  87      than one compiler in this fashion.  Therefore cw does not accept multiple
  88      source files unless the preprocessor is to be invoked.  An attempt to
  89      invoke cw in this manner will result in an error.
  90 
  91 ARGUMENT TRANSLATION
  92      If the compiler to be invoked is a GNU-style C or C++ compiler, a set of
  93      default flags is added to the beginning of the argument list, and the




  52              the form -_name= and -_style= Where name and style are those
  53              passed to --primary and --shadow this allows certain flags to be
  54              passed only to certain classes of compiler.
  55 
  56              For historical reasons, the -_style= option is also translated
  57              such that a style of sun may use the flag -_cc= and a style of
  58              gnu may use the flag -_gcc=, and when the -C option is given and
  59              C++ is in use the style of sun may use the flag -_CC= and the
  60              style of gnu may use the flag -_g++=.
  61 
  62 SHADOW COMPILATION
  63      If --shadow compilers are specified cw will invoke shadow compiler, with
  64      the outputs modified (as well as any translation for compiler style) as
  65      follows:
  66 
  67      1.   If none of -c, -E, -P, or -S appears in the argument list (that is,
  68           linking is attempted), the shadow compilers will not be invoked.
  69           This is because the objects built with that compiler which would be
  70           linked have been previously discarded.
  71 
  72      2.   If the -o filename option was provided, with or without a separating
  73           space, it will be replaced with -o tempfile
  74 
  75      3.   If the option -o was not provided, -o tempfile will be added to the
  76           end of the argument list used to invoke the shadow compilers.
  77      When shadow compilation is in effect, cw writes to standard error each
  78      compiler's standard error output following its argument list.  Messages
  79      from the compilers will not be interleaved.  If cw is used to invoke the
  80      preprocessor and no output location is specified, cw will write to
  81      standard output the primary compiler's standard output, and the secondary
  82      compiler's standard output will be discarded.
  83 
  84      Because the Sun compilers write intermediate objects to fixed filenames
  85      in the current directory when instructed to compile and link multiple
  86      source files via a single command line, it would be unsafe to invoke more
  87      than one compiler in this fashion.  Therefore cw does not accept multiple
  88      source files unless the preprocessor is to be invoked.  An attempt to
  89      invoke cw in this manner will result in an error.
  90 
  91 ARGUMENT TRANSLATION
  92      If the compiler to be invoked is a GNU-style C or C++ compiler, a set of
  93      default flags is added to the beginning of the argument list, and the