5.6.2.1 General

Table 5-2. General Category
Option	Description	Command Line¹
Have symbols in production build	Generate debugging information for source-level debugging in MPLAB® X IDE.	`--gdwarf-2`
Keep local symbols	Check to keep local symbols, that is, labels beginning with `.L` (upper case only). Uncheck to discard local symbols.	`--keep-locals`
Preprocessor macro definitions	Project-specific preprocessor macro defines passed via the compiler's `–D` option.	`-Dmacro[=defn]`
Assembler symbols	Define symbol `sym` to a given `value`.	`--defsym sym=value`
Preprocessor Include directories	Add a directory to the list of those searched for headers included by the preprocessor. Relative paths are from MPLAB X project directory.	`-I dir`
Assembler Include directories	Add a directory to the list of those searched for files specified in `.include` directives. Relative paths are from MPLAB X project directory. You may add as many directories as necessary to include a variety of paths. The current working directory is always searched first and then `-I` directories in the order in which they were specified (left to right) here.	`-Idir`
Allow call optimization	Turn relaxation on. Convert absolute calls and gotos to relative calls and branches when possible.	`--relax`
Additional driver options	Add driver options not already available in this interface. The string you introduce here will be emitted as-is in the driver invocation command.
For details on assembler command-line options, see MPLAB® XC32 Assembler, Linker and Utilities User’s Guide for PIC32A MCU.

Have symbols in production build

Generate debugging information for source-level debugging in MPLAB® X IDE.

--gdwarf-2

Keep local symbols

Check to keep local symbols, that is, labels beginning with .L (upper case only).

Uncheck to discard local symbols.

--keep-locals

Preprocessor macro definitions

Project-specific preprocessor macro defines passed via the compiler's –D option.

-Dmacro[=defn]

Assembler symbols

Define symbol sym to a given value.

--defsym sym=value

Preprocessor Include directories

Add a directory to the list of those searched for headers included by the preprocessor. Relative paths are from MPLAB X project directory.

-I dir

Assembler Include directories

Add a directory to the list of those searched for files specified in .include directives. Relative paths are from MPLAB X project directory.

You may add as many directories as necessary to include a variety of paths. The current working directory is always searched first and then -I directories in the order in which they were specified (left to right) here.

-Idir

Allow call optimization

Turn relaxation on. Convert absolute calls and gotos to relative calls and branches when possible.

--relax

Additional driver options

Add driver options not already available in this interface. The string you introduce here will be emitted as-is in the driver invocation command.

For details on assembler command-line options, see MPLAB® XC32 Assembler, Linker and Utilities User’s Guide for PIC32A MCU.