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

Product codes
SW006021-1
Page of 518
MPLAB
®
 XC8 C Compiler User’s Guide
DS52053B-page 106
 2012 Microchip Technology Inc.
4.8.34
--HTML: Generate HTML Diagnostic Files
This option will generate a series of HTML files that can be used to explore the compi-
lation results of the latest build. The files are stored in a directory called html, located 
in the output directory. The top level file (which can be opened with your favorite web 
browser) is called index.html.
Use this option at all stages of compilation to ensure files associated with all compila-
tion stages are generated.
The index page is a graphical representation of the compilation process. Each file icon 
is clickable and will open with the contents of that file. This is available for all interme-
diate files, and even binary files open in a human-readable form. Each application icon 
can also be clicked to show a page containing information about that application’s 
options and build results.
The list of all preprocessor macros (preprocessor icon) and a graphical memory usage 
map (Linker icon) provide information that is not otherwise readily accessible.
4.8.35
--LANG: Specify the Language for Messages
This option allows the compiler to be configured to produce error, warning and some 
advisory messages in languages other than English.
English is the default language unless this has been changed at installation, or by the 
use of the --SETUP option. Some messages are only ever printed in English regard-
less of the language specified with this option. For more information, see 
Section 4.6.2 “Message Language”.
Table 4-12 shows those languages currently supported.
4.8.36
--MEMMAP: Display Memory Map
This option will display a memory map for the map file specified with this option. The 
information printed is controlled by the --SUMMARY option, see 
Section 4.8.56 “--SUMMARY: Select Memory Summary Output Type”, for exam-
ple:
xc8 --memmap=size.map --summary=psect,class,file
This option is seldom required, but would be useful if the linker is being driven explicitly; 
i.e., instead of in the normal way through the command-line driver. This command 
would display the memory summary which is normally produced at the end of compila-
tion by the driver.
4.8.37
--MODE: Choose Compiler Operating Mode
This option selects the basic operating mode of the compiler. The available types are 
pro
, std and free. For legacy projects, the mode lite is accepted to mean the Free 
operating mode. A compiler operating in PRO mode uses full optimization and pro-
duces the smallest code size. Standard mode uses limited optimizations, and Free 
mode only uses a minimum optimization level and will produce relatively large code.
TABLE 4-12:
SUPPORTED LANGUAGES
Suboption
 Language
en
, english
 English (default)
fr
, french, francais
 French
de
, german, deutsch
 German