MPLAB C Compiler for PIC24 MCUs and dsPIC DSCs ... - Microchip

16-Bit C Compiler User’s Guide
TABLE 3-11: PREPROCESSOR OPTIONS (CONTINUED)
Option Definition
-C Tell the preprocessor not to discard comments. Used with the
-E option.
-dD Tell the preprocessor to not remove macro definitions into the
output, in their proper sequence.
-Dmacro Define macro macro with the string 1 as its definition.
-Dmacro=defn Define macro macro as defn. All instances of -D on the
command line are processed before any -U options.
-dM Tell the preprocessor to output only a list of the macro
definitions that are in effect at the end of preprocessing. Used
with the -E option.
-dN Like -dD except that the macro arguments and contents are
omitted. Only #define name is included in the output.
-fno-show-column Do not print column numbers in diagnostics. This may be
necessary if diagnostics are being scanned by a program that
does not understand the column numbers, such as dejagnu.
-H Print the name of each header file used, in addition to other
normal activities.
-I- Any directories you specify with -I options before the -Ioptions
are searched only for the case of #include "file";
they are not searched for #include .
If additional directories are specified with -I options after the
-I-, these directories are searched for all #include
directives. (Ordinarily all -I directories are used this way.)
In addition, the -I- option inhibits the use of the current
directory (where the current input file came from) as the first
search directory for #include "file". There is no way to
override this effect of -I-. With -I. you can specify searching
the directory that was current when the compiler was invoked.
That is not exactly the same as what the preprocessor does by
default, but it is often satisfactory.
-I- does not inhibit the use of the standard system directories
for header files. Thus, -I- and -nostdinc are independent.
-Idir Add the directory dir to the head of the list of directories to be
searched for header files. This can be used to override a
system header file, substituting your own version, since these
directories are searched before the system header file
directories. If you use more than one -I option, the directories
are scanned in left-to-right order; the standard system
directories come after.
-idirafter dir Add the directory dir to the second include path. The
directories on the second include path are searched when a
header file is not found in any of the directories in the main
include path (the one that -I adds to).
-imacros file Process file as input, discarding the resulting output, before
processing the regular input file. Because the output generated
from the file is discarded, the only effect of -imacros file is
to make the macros defined in file available for use in the main
input.
Any -D and -U options on the command line are always
processed before -imacros file, regardless of the order in
which they are written. All the -include and -imacros
options are processed in the order in which they are written.
DS51284H-page 52 © 2008 Microchip Technology Inc.