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

Using the Compiler on the Command Line
TABLE 3-11: PREPROCESSOR OPTIONS (CONTINUED)
Option Definition
-include file Process file as input before processing the regular input file. In
effect, the contents of file are compiled first. Any -D and -U
options on the command line are always processed before
-include 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.
-iprefix prefix Specify prefix as the prefix for subsequent -iwithprefix
options.
-isystem dir Add a directory to the beginning of the second include path,
marking it as a system directory, so that it gets the same special
treatment as is applied to the standard system directories.
-iwithprefix dir Add a directory to the second include path. The directory’s
name is made by concatenating prefix and dir, where prefix
was specified previously with -iprefix. If a prefix has not yet
been specified, the directory containing the installed passes of
the compiler is used as the default.
-iwithprefixbefore
dir
Add a directory to the main include path. The directory’s name
is made by concatenating prefix and dir, as in the case of
-iwithprefix.
-M Tell the preprocessor to output a rule suitable for make describing
the dependencies of each object file. For each source file,
the preprocessor outputs one make-rule whose target is the
object file name for that source file and whose dependencies
are all the #include header files it uses. This rule may be a
single line or may be continued with \-newline if it is long. The
list of rules is printed on standard output instead of the preprocessed
C program.
-M implies -E (see Section 3.5.2 “Options for Controlling
the Kind of Output”).
-MD Like -M but the dependency information is written to a file and
compilation continues. The file containing the dependency
information is given the same name as the source file with a .d
extension.
-MF file When used with -M or -MM, specifies a file in which to write the
dependencies. If no -MF switch is given, the preprocessor
sends the rules to the same place it would have sent
preprocessed output.
When used with the driver options, -MD or -MMD, -MF,
overrides the default dependency output file.
-MG Treat missing header files as generated files and assume they
live in the same directory as the source file. If -MG is specified,
then either -M or -MM must also be specified. -MG is not
supported with -MD or -MMD.
-MM Like -M but the output mentions only the user header files
included with #include “file”. System header files included
with #include are omitted.
-MMD Like -MD except mention only user header files, not system
header files.
© 2008 Microchip Technology Inc. DS51284H-page 53