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