-#

Category

Error checking and debugging

@PROCESS

None.

Purpose

Previews the compilation steps specified on the command line, without actually invoking any compiler components.

At the points where the compiler executes commands to perform different compilation steps, this option displays a simulation of the commands it would run and the system argument lists it would pass, but it does not actually perform these actions.

Syntax

Read syntax diagramSkip visual syntax diagram
Option:

>>- -# --------------------------------------------------------><

Defaults

Not applicable.

Usage

Examining the output of this option can help you quickly and safely determine the following information for a particular compilation:
  • What files are involved
  • What options are in effect for each step

It avoids the overhead of compiling the source code and avoids overwriting any existing files, such as .lst files. (If you are familiar with the make command, it is similar to make -n.)

This option produces the same output as -v and -V, but does not perform the compilation.

Note that if you specify this option with -qipa, the compiler does not display linker information subsequent to the IPA link step. This is because the compiler does not actually call IPA.

Related information