Microchip Technology XC8 Standard Compiler (Workstation) SW006021-1 SW006021-1 User Manual

 2012 Microchip Technology Inc.

DS52053B-page 97

This option allows the significant C identifier length (used by functions and variables) 
to be decreased from the default value of 255. Valid sizes for this option are from 32 to 
255. The option has no effect for all other values.

This option also controls the significant length of identifiers used by the preprocessor, 
such as macro names. The default length is also 255, and can be adjusted to a 
minimum of 31.

If the --STRICT option is used, the default significant identifier length is reduced to 31. 
Code which uses a longer identifier length will be less portable.

See Section 4.9 “MPLAB IDE V8 Universal Toolsuite Equivalents” or 
Section 4.10 “MPLAB X Universal Toolsuite Equivalents” for use of this option in 
MPLAB IDE.

This option allows the basename of the output file(s) to be specified. If no -O option is 
given, the base name of output file(s) will be the same as the project name, see 
Section 4.3 “The Compilation Sequence”. The files whose names are affected by 
this option are those files that are not directly associated with any particular source file, 
such as the HEX file, MAP file and SYM file.

The -O option can also change the directory in which the output file is located by includ-
ing the required path before the filename. This will then also specify the output directory 
for any files produced by the linker or subsequently run applications. Any relative paths 
specified are with respect to the current working directory.

For example, if the option -Oc:\project\output\first is used, the MAP and 
HEX file, etc., will use the base name first, and will be placed in the directory 
c:\project\output

.

Any extension supplied with the filename will be ignored.

The options that specify MAP file creation (-M, see Section 4.8.8 “-M: Generate Map 
File”), and SYM file creation (-G, see Section 4.8.4 “-G: Generate Source-Level 
Symbol File”) override any name or path information provided by -O relevant to the 
MAP and SYM file.

To change the directory in which all output and intermediate files are written, use the 
--OUTDIR

 option, see Section Section 4.8.43 “--OUTDIR: Specify a Directory For 

Output Files”. Note that if -O specifies a path which is inconsistent with the path 
specified in the --OUTDIR option, this will result in an error.

The -P option causes assembler source files to be preprocessed before they are 
assembled, thus allowing the use of preprocessor directives, such as #include, and 
C-style comments with assembler code.

By default, assembler files are not preprocessed.

See Section 4.9 “MPLAB IDE V8 Universal Toolsuite Equivalents” or 
Section 4.10 “MPLAB X Universal Toolsuite Equivalents” for use of this option in 
MPLAB IDE.

This option places the compiler in a quiet mode which suppresses the Microchip 
Technology Incorporated copyright notice from being displayed.