cpopts.gml

开放源码的编译器open watcom 1.6.0版的源代码

.chap *refid=cpopts &product Compiler Options
.*
.np
.ix 'options'
.if '&target' eq 'QNX' .do begin
This chapter describes all the compiler options that are available.
.do end
.el .do begin
Source files can be compiled using either the IDE or command-line
compilers.
This chapter describes all the compiler options that are available.
.np
For information about compiling applications from the &vip,
see the
.book &company Graphical Tools User's Guide.
.np
For information about compiling applications from the command line,
see the chapter entitled :HDREF refid='cpwcc'..
.np
The &product compiler command names (
.ct .us compiler_name
.ct ) are:
.ix 'command name' 'compiler'
.if '&target' eq 'QNX' .do begin
.begnote $compact
.note &ccmd16
the &cmpcname compiler for 16-bit Intel platforms.
.note &pcmd16
the &cmppname compiler for 16-bit Intel platforms.
.note &ccmd32
the &cmpcname compiler for 32-bit Intel platforms.
.note &pcmd32
the &cmppname compiler for 32-bit Intel platforms.
.if '&alpha' eq 'AXP' .do begin
.note &ccmdAX
the &cmpcname compiler for DEC Alpha AXP platforms.
.note &pcmdAX
the &cmppname compiler for DEC Alpha AXP platforms.
.do end
.endnote
.do end
.el .do begin
.begnote $compact
.note &ccmdup16
the &cmpcname compiler for 16-bit Intel platforms.
.note &pcmdup16
the &cmppname compiler for 16-bit Intel platforms.
.note &ccmdup32
the &cmpcname compiler for 32-bit Intel platforms.
.note &pcmdup32
the &cmppname compiler for 32-bit Intel platforms.
.if '&alpha' eq 'AXP' .do begin
.note &ccmdupAX
the &cmpcname compiler for DEC Alpha AXP platforms.
.note &pcmdupAX
the &cmppname compiler for DEC Alpha AXP platforms.
.do end
.endnote
.do end
.*
.if &e'&dohelp eq 1 .do begin
.*
.section Compiler Options - Indexed
.*
.np
.ix 'compiling options'
In this section, we present an index of all compiler options.
.* .begnote $compact $setptnt 10
.* .notehd1 Option:
.* .notehd2 See description:
.im CPOPTLST
.* .endnote
.do end
.*
.section Compiler Options - Summarized Alphabetically
.*
.np
.ix 'compiling options'
In this section, we present a terse summary of compiler options.
This summary is displayed on the screen by simply entering the
compiler command name with no arguments.
.begnote $compact $setptnt 10
.notehd1 Option:
.notehd2 Description:
.im CPOPTSUM
.endnote
.*
.section Compiler Options - Summarized By Category
.*
.np
.ix 'compiling options'
In the following sections, we present a terse summary of compiler
options organized into categories.
.*
.beglevel
.*
.helppref Summary:
.*
.section Target Specific
.*
.begnote $compact $setptnt 10
.ix 'options' 'target specific'
.notehd1 Option:
.notehd2 Description:
.if &e'&$SWbc eq 1 .do begin
.note bc
build target is a console application
:optref refid='SWbc'.
.do end
.if &e'&$SWbd eq 1 .do begin
.note bd
build target is a Dynamic Link Library (DLL)
:optref refid='SWbd'.
.do end
.if &e'&$SWbg eq 1 .do begin
.note bg
build target is a GUI application
:optref refid='SWbg'.
.do end
.if &e'&$SWbm eq 1 .do begin
.note bm
build target is a multi-threaded environment
:optref refid='SWbm'.
.do end
.if &e'&$SWbr eq 1 .do begin
.note br
build target uses DLL version of C/C++ run-time library
:optref refid='SWbr'.
.do end
.if &e'&$SWbt eq 1 .do begin
.note bt[=<os>]
build target for operating system <os>
:optref refid='SWbt'.
.do end
.if &e'&$SWbw eq 1 .do begin
.note bw
build target uses default windowing support
:optref refid='SWbw'.
.do end
.if &e'&$SWof eq 1 .do begin
.note of
generate traceable stack frames as needed
:optref refid='SWof'.
.do end
.if &e'&$SWofpls eq 1 .do begin
.note of+
always generate traceable stack frames
:optref refid='SWofpls'.
.do end
.if &e'&$SWsg eq 1 .do begin
.note sg
generate calls to grow the stack
:optref refid='SWsg'.
.do end
.if &e'&$SWst eq 1 .do begin
.note st
touch stack through SS first
:optref refid='SWst'.
.do end
.if &e'&$SWzw eq 1 .do begin
.note zw
generate code for Microsoft Windows
:optref refid='SWzw'.
.do end
.if &e'&$SWzW86 eq 1 .do begin
.note zW
&286only.
Microsoft Windows optimized prologue/epilogue code sequences
:optref refid='SWzW86'.
.do end
.if &e'&$SWzWs eq 1 .do begin
.note zWs
&286only.
Microsoft Windows smart callback sequences
:optref refid='SWzWs'.
.do end
.endnote
.*
.section Debugging/Profiling
.*
.begnote $compact $setptnt 10
.ix 'options' 'debugging/profiling'
.notehd1 Option:
.notehd2 Description:
.if &e'&$SWd0 eq 1 .do begin
.note d0
(C++ only)
no debugging information
:optref refid='SWd0'.
.do end
.if &e'&$SWd1 eq 1 .do begin
.note d1
line number debugging information
:optref refid='SWd1'.
.do end
.if &e'&$SWd1pls eq 1 .do begin
.note d1+
(C only)
line number debugging information plus typing information for global
symbols and local structs and arrays
:optref refid='SWd1pls'.
.do end
.if &e'&$SWd2 eq 1 .do begin
.note d2
full symbolic debugging information
:optref refid='SWd2'.
.do end
.if &e'&$SWd2i eq 1 .do begin
.note d2i
(C++ only)
d2 and debug inlines; emit inlines as external out-of-line functions
:optref refid='SWd2i'.
.do end
.if &e'&$SWd2s eq 1 .do begin
.note d2s
(C++ only)
d2 and debug inlines; emit inlines as static out-of-line functions
:optref refid='SWd2s'.
.do end
.if &e'&$SWd2t eq 1 .do begin
.note d2t
(C++ only)
d2 but without type names
:optref refid='SWd2t'.
.do end
.if &e'&$SWd3 eq 1 .do begin
.note d3
full symbolic debugging with unreferenced type names
:optref refid='SWd3'.
.do end
.if &e'&$SWd3i eq 1 .do begin
.note d3i
(C++ only)
d3 plus debug inlines; emit inlines as external out-of-line functions
:optref refid='SWd3i'.
.do end
.if &e'&$SWd3s eq 1 .do begin
.note d3s
(C++ only)
d3 plus debug inlines; emit inlines as static out-of-line functions
:optref refid='SWd3s'.
.do end
.if &e'&$SWee eq 1 .do begin
.note ee
call epilogue hook routine
:optref refid='SWee'.
.do end
.if &e'&$SWen eq 1 .do begin
.note en
emit routine names in the code segment
:optref refid='SWen'.
.do end
.if &e'&$SWep eq 1 .do begin
.note ep[<number>]
call prologue hook routine with number stack bytes available
:optref refid='SWep'.
.do end
.if &e'&$SWet eq 1 .do begin
.note et
Pentium profiling
:optref refid='SWet'.
.do end
.if &e'&$SWhwdc eq 1 .do begin
.note h{w,d,c}
set debug output format (&company, DWARF, Codeview)
:optref refid='SWhwdc'
.do end
.if &e'&$SWs eq 1 .do begin
.note s
remove stack overflow checks
:optref refid='SWs'.
.do end
.if &e'&$SWsi eq 1 .do begin
.note si
&AXPonly.
initialize stack frame storage with pattern
:optref refid='SWsi'.
.do end
.endnote
.*
.section Preprocessor
.*
.begnote $compact $setptnt 10
.ix 'options' 'preprocessor'
.notehd1 Option:
.notehd2 Description:
.if &e'&$SWd eq 1 .do begin
.note d<name>[=text]
precompilation #define name [text]
:optref refid='SWd'.
.do end
.if &e'&$SWdpls eq 1 .do begin
.note d+
allow extended "d" macro definitions on command line
:optref refid='SWdpls'.
.do end
.if &e'&$SWfo eq 1 .do begin
.note fo[=<file_name>]
set preprocessor output file name
:optref refid='SWfo'.
.do end
.if &e'&$SWpil eq 1 .do begin
.note pil
preprocessor ignores #line directives
:optref refid='SWpil'.
.do end
.if &e'&$SWp eq 1 .do begin
.note p{e,l,c,w=<num>}
preprocess file
.begnote $compact
.note c
preserve comments
.note e
encrypt identifiers (C++ only)
.note l
insert #line directives
.note w=<num>
wrap output lines at <num> columns. Zero means no wrap.
.endnote
.np
:optref refid='SWp'.
.do end
.if &e'&$SWu eq 1 .do begin
.note u<name>
undefine macro name
:optref refid='SWu'.
.do end
.endnote
.*
.section Diagnostics
.*
.begnote $compact $setptnt 10
.ix 'options' 'diagnostics'
.notehd1 Option:
.notehd2 Description:
.if &e'&$SWe eq 1 .do begin
.note e<number>
set error limit number
:optref refid='SWe'.
.do end
.if &e'&$SWef eq 1 .do begin
.note ef
use full path names in error messages
:optref refid='SWef'.
.do end
.if &e'&$SWeq eq 1 .do begin
.note eq
do not display error messages (they are still written to a file)
:optref refid='SWeq'.
.do end
.if &e'&$SWer eq 1 .do begin
.note er
(C++ only)
do not recover from undefined symbol errors
:optref refid='SWer'.
.do end
.if &e'&$SWew eq 1 .do begin
.note ew
(C++ only)
alternate error message formatting
:optref refid='SWew'.
.do end
.if &e'&$SWq eq 1 .do begin
.note q
operate quietly
:optref refid='SWq'.
.do end
.if &e'&$SWt eq 1 .do begin
.note t=<num>
set tab stop multiplier
:optref refid='SWt'.
.do end
.if &e'&$SWw eq 1 .do begin
.note w<number>
set warning level number
:optref refid='SWw'.
.do end
.if &e'&$SWwcd eq 1 .do begin
.note wcd=<num>
warning control: disable warning message <num>
:optref refid='SWwcd'.
.do end
.if &e'&$SWwce eq 1 .do begin
.note wce=<num>
warning control: enable warning message <num>
:optref refid='SWwce'.
.do end
.if &e'&$SWwe eq 1 .do begin
.note we
treat all warnings as errors
:optref refid='SWwe'.
.do end
.if &e'&$SWwx eq 1 .do begin
.note wx
set warning level to maximum setting
:optref refid='SWwx'.
.do end
.if &e'&$SWza eq 1 .do begin
.note z{a,e}
disable/enable language extensions
:optref refid='SWza'.
:optref refid='SWze'.
.do end
.if &e'&$SWzq eq 1 .do begin
.note zq
operate quietly
:optref refid='SWzq'.
.do end
.if &e'&$SWzs eq 1 .do begin
.note zs
syntax check only
:optref refid='SWzs'.
.do end
.endnote
.*
.section Source/Output Control
.*
.begnote $compact $setptnt 10
.ix 'options' 'source/output control'
.notehd1 Option:
.notehd2 Description:
.if &e'&$SWad eq 1 .do begin
.note ad[=<file_name>]
generate makefile style auto depend file
:optref refid='SWad'.
.do end
.if &e'&$SWadbs eq 1 .do begin
.note adbs
force slashes generated in makefile style auto depend to backward
:optref refid='SWadbs'.
.do end
.if &e'&$SWadd eq 1 .do begin
.note add[=<file_name>]
set source depend name for makefile style auto depend file
:optref refid='SWadd'.
.do end
.if &e'&$SWadhp eq 1 .do begin
.note adhp[=<path prefix>]
set default path for header dependancies which result in name only.
:optref refid='SWadhp'.
.do end
.if &e'&$SWadfs eq 1 .do begin
.note adfs
force slashes generated in makefile style auto depend to forward
:optref refid='SWadfs'.
.do end
.if &e'&$SWadt eq 1 .do begin
.note adt[=<target_name>]
specify target name generated in makefile style auto depend
:optref refid='SWadt'.
.do end
.if &e'&$SWdb eq 1 .do begin
.note db
generate browsing information
:optref refid='SWdb'.
.do end
.if &e'&$SWez eq 1 .do begin
.note ez
generate PharLap EZ-OMF object files
:optref refid='SWez'.
.do end
.if &e'&$SWfc eq 1 .do begin
.note fc=<file_name>
(C++ only)
specify file of command lines to be batch processed
:optref refid='SWfc'.
.do end
.if &e'&$SWfh eq 1 .do begin
.note fh[q][=<file_name>]
use precompiled headers
:optref refid='SWfh'.
.do end
.if &e'&$SWfhd eq 1 .do begin
.note fhd
store debug info for pre-compiled header once (DWARF only)
:optref refid='SWfhd'.
.do end
.if &e'&$SWfhr eq 1 .do begin
.note fhr
(C++ only)
force compiler to read pre-compiled header (will never write)
:optref refid='SWfhr'.
.do end
.if &e'&$SWfhw eq 1 .do begin
.note fhw
(C++ only)
force compiler to write pre-compiled header (will never read)
:optref refid='SWfhw'.
.do end
.if &e'&$SWfhwe eq 1 .do begin
.note fhwe
(C++ only)
don't include pre-compiled header warnings when "we" is used
:optref refid='SWfhwe'.
.do end
.if &e'&$SWfi eq 1 .do begin
.note fi=<file_name>