Microchip Technology XC8 Standard Compiler (Workstation) SW006021-1 SW006021-1 User Manual
Product codes
SW006021-1
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.
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.
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.
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.
map (Linker icon) provide information that is not otherwise readily accessible.
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.
Section 4.10 “MPLAB X Universal Toolsuite Equivalents” for use of this option in
MPLAB IDE.
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.
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”.
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:
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.
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
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.
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