optsumry.gml

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

*$[NO]Reference
.millust end
.pc
This option is most useful when used in an include file that is
included by several subprograms.
Consider an include file that defines many parameter constants and
only a few are referenced by any one subprogram.
If the first line of the include file is
.millust begin
*$noreference
.millust end
.pc
and the last line is
.millust begin
*$reference
.millust end
.pc
warning messages for all unused parameter constants in the include
file would be suppressed.
The default option is "reference".
.*
.note [NO]RESource
.ixm 'RESOURCE option'
.ixm 'options' 'RESOURCE'
:cmt. .ixm 'NORESOURCE option'
:cmt. .ixm 'options' 'NORESOURCE'
The "resource" option specifies that the run-time error messages are
contained as resource information in the executable file.
All messages will be extracted from the resource area of the
executable file when they are required; no messages will be linked
with the application.
The default option is "noresource".
.*
.if '&cmpclass' eq 'load-n-go' .do begin
.*
.note [NO]RUN
.ixm 'RUN option'
.ixm 'options' 'RUN'
:cmt. .ixm 'NORUN option'
:cmt. .ixm 'options' 'NORUN'
This option is used to control whether the executable file generated by
specifying the "link" option is executed automatically by the compiler.
If the "run" option is specified, the executable file will be executed.
If the "norun" option is specified, the executable file will only be
generated and not executed.
The default option is "norun".
.*
.do end
.*
.if '&cmpclass' ne 'load-n-go' .do begin
.*
.note [NO]SAve
.ixm 'SAVE option'
.ixm 'options' 'SAVE'
:cmt. .ixm 'NOSAVE option'
:cmt. .ixm 'options' 'NOSAVE'
The "save" option is used to instruct &cmpname to "save" all local
variables of subprograms.
All local variables are treated as if they had appeared in FORTRAN 77
.kw SAVE
statements.
By default, local variables are not saved unless named in a
.kw SAVE
statement (i.e., "nosave" is the default option).
.*
.note [NO]SC
.ixm 'SC option'
.ixm 'options' 'SC'
:cmt. .ixm 'NOSC option'
:cmt. .ixm 'options' 'NOSC'
(32-bit only)
If the "sc" option is used, &cmpname will pass all arguments on the
stack.
The resulting code will be larger than that which is generated for the
register method of passing arguments.
The default option is "nosc".
.*
.note [NO]SEpcomma
.ixm 'SEPCOMMA option'
.ixm 'options' 'SEPCOMMA'
:cmt. .ixm 'NOSEPCOMMA option'
:cmt. .ixm 'options' 'NOSEPCOMMA'
The "sepcomma" option allows the comma (",") to be used as field
separator in formatted input.
Thus the following code would work with the input described.
.exam begin
    REAL R, S

    READ(5,21) R, S
    PRINT *, R, S
21  FORMAT(2F11.3)
    END
.exam end
.np
Normally the following input would result in a run-time error message.
.millust begin
0.79,0.21
.millust end
.*
.note [NO]SG
.ix 'stack growing'
.ixm 'SG option'
.ixm 'options' 'SG'
:cmt. .ixm 'NOSG option'
:cmt. .ixm 'options' 'NOSG'
(32-bit only)
.ix 'multi-threaded applications'
The "sg" option is useful for 32-bit OS/2 multi-threaded applications.
It requests the code generator to emit a run-time call at the start of
any function that has more than 4K bytes of automatic variables
(variables located on the stack).
Under 32-bit OS/2, the stack is grown automatically in 4K pages
using the stack "guard page" mechanism.
The stack consists of in-use committed pages topped off with a special
guard page.
A memory reference into the 4K guard page causes OS/2 to grow the
stack by one 4K page and to add a new 4K guard page.
This works fine when there is less than 4K of automatic variables in a
function.
When there is more than 4K of automatic data, the stack must be grown
in an orderly fashion, 4K bytes at a time, until the stack has grown
sufficiently to accommodate all the automatic variable storage
requirements.
.np
.ix 'stack growing' '__GRO'
.ix '__GRO' 'stack growing'
The "stack growth" run-time routine is called
.id __GRO.
.np
The default option is "nosg".
.*
.do end
.*
.note [NO]SHort
.ixm 'SHORT option'
.ixm 'options' 'SHORT'
:cmt. .ixm 'NOSHORT option'
:cmt. .ixm 'options' 'NOSHORT'
The "short" option is used to instruct &cmpname to set the default
INTEGER size to 2 bytes and the default LOGICAL size to 1 bytes.
As required by the FORTRAN 77 language standard, the default INTEGER
size is 4 bytes and the default LOGICAL size is 4 bytes.
The default option is "noshort".
.*
.if '&cmpclass' ne 'load-n-go' .do begin
.*
.note [NO]SR
.ixm 'SR option'
.ixm 'options' 'SR'
:cmt. .ixm 'NOSR option'
:cmt. .ixm 'options' 'NOSR'
The "sr" option instructs &cmpname to generate subprogram prologue and
epilogue sequences that save and restore any segment registers that
are modified by the subprogram.
Caution should be exercised when using this option.
.ix 'GPF'
.ix 'general protection fault'
If the value of the segment register being restored matches the value
of a segment that was freed within the subprogram, a general
protection fault will occur in protected-mode environments.
The default, "nosr",  does not save and restore segment registers.
.*
.note [NO]SSfloats
.ixm 'SSFLOATS option'
.ixm 'options' 'SSFLOATS'
:cmt. .ixm 'NOSSFLOATS option'
:cmt. .ixm 'options' 'NOSSFLOATS'
(16-bit only)
The "ssfloats" option specifies that the segment register SS does not
necessarily point to the default data segment.
.ix 'multi-threaded applications'
.ix 'dynamic link library applications'
.ix 'DLL applications'
The "ssfloats" option must be specified when compiling a module that
is part of an OS/2 multi-threaded application or dynamic link library.
By default, it is assumed that the SS segment register contains the
segment address of the default data segment (i.e., "nossfloats").
.*
.note [NO]STack
.ixm 'STACK option'
.ixm 'options' 'STACK'
:cmt. .ixm 'NOSTACK option'
:cmt. .ixm 'options' 'NOSTACK'
If "stack" is specified, &cmpname will emit code at the beginning of
every subprogram that will check for the "stack overflow" condition.
By default, stack overflow checking is omitted from the generated code
("nostack").
.*
.do end
.*
.if '&cmpclass' eq 'load-n-go' .do begin
.*
.note Statements=<n>
.ixm 'STATEMENTS=<n> option'
.ixm 'options' 'STATEMENTS=<n>'
This option is used to control the maximum number of statements that
will be executed once the program enters the execution phase.
.us n
must be an unsigned integer constant.
If
.us n
is 0, no limit on the number statements that will be executed is
imposed.
This is the default.
.*
.do end
.*
.if '&cmpclass' ne 'load-n-go' .do begin
.*
.note [NO]SYntax
.ixm 'SYNTAX option'
.ixm 'options' 'SYNTAX'
:cmt. .ixm 'NOSYNTAX option'
:cmt. .ixm 'options' 'NOSYNTAX'
If "syntax" is specified, &cmpname will check the source code only and
omit the generation of object code.
Syntax checking, type checking, and so on are performed as usual.
By default, code is generated if there are no source code errors
(i.e., "nosyntax" is the default).
.*
.do end
.*
.note [NO]TErminal
.ixm 'TERMINAL option'
.ixm 'options' 'TERMINAL'
:cmt. .ixm 'NOTERMINAL option'
:cmt. .ixm 'options' 'NOTERMINAL'
The "noterminal" option may be used to suppress the display of
diagnostic messages to the screen.
By default, diagnostic messages are displayed.
.*
.if '&cmpclass' eq 'load-n-go' .do begin
.*
.note Time=<t>
.ixm 'TIME=<t> option'
.ixm 'options' 'TIME=<t>'
This option is used to control the maximum amount of time, in seconds,
that is allotted to a program once it begins executing.
.us t
must be an unsigned integer constant.
If
.us t
is 0, no limit on the execution time is imposed.
This is the default.
.np
Note that execution time is the elapsed time using the time-of-day
clock and includes time for input/output.
.*
.do end
.*
.if '&cmpclass' ne 'load-n-go' .do begin
.*
.note [NO]TRace
.ixm 'TRACE option'
.ixm 'options' 'TRACE'
:cmt. .ixm 'NOTRACE option'
:cmt. .ixm 'options' 'NOTRACE'
The "trace" option causes the generation of code that allows a
traceback to be issued when an error occurs during the execution of
your program.
The default option is "notrace".
.*
.do end
.*
.note TYpe
.ixm 'TYPE option'
.ixm 'options' 'TYPE'
This option is used to direct the listing file to the terminal (device
name "CON") instead of the disk.
The "type" option will override any previously specified "print" or
"disk" option.
The default is to create a listing file on the disk.
.*
.note [NO]WArnings
.ixm 'WARNINGS option'
.ixm 'options' 'WARNINGS'
:cmt. .ixm 'NOWARNINGS option'
:cmt. .ixm 'options' 'NOWARNINGS'
This option is used to control the printing of warning messages.
By default, warning messages are printed.
This option may be specified on the command line or it may be placed
anywhere in the source input stream.
In a source file, the option appears as a comment line and takes the
following form.
.millust begin
*$[NO]WArnings
.millust end
.pc
The "warnings" option enables the printing of warning messages, while
"nowarnings" disables the printing of these messages.
.*
.note [NO]WILd
.ixm 'WILD option'
.ixm 'options' 'WILD'
:cmt. .ixm 'NOWILD option'
:cmt. .ixm 'options' 'NOWILD'
The "wild" option suppresses the compile-time checking that normally
causes an error to be issued when an attempt is made to transfer
control into a block structure from outside the block structure and
vice versa.
For example, this option will allow a transfer of control into an
IF-block from outside the IF-block (which is normally prohibited).
The default option is "nowild".
.np
Extreme caution should be exercised when using this option.
For example, transfer of control into a DO-loop from outside the
DO-loop can cause unpredictable results.
This programming style is not encouraged by this option.
The option has been made available so that existing programs that do
not adhere to the branching restrictions imposed by the FORTRAN 77
standard (i.e. mainframe applications that are being ported to the PC
environment), can be compiled by &product..
.*
.if '&cmpclass' ne 'load-n-go' .do begin
.*
.note [NO]WIndows
.ixm 'WINDOWS option'
.ixm 'options' 'WINDOWS'
:cmt. .ixm 'NOWINDOWS option'
:cmt. .ixm 'options' 'NOWINDOWS'
(16-bit only)
The "windows" option causes the compiler to generate the
prologue/epilogue code sequences necessary for use in Microsoft
Windows applications.
The default option is "nowindows".
.*
.do end
.*
.if '&cmpclass' ne 'load-n-go' .do begin
.*
.note [NO]XFloat
.ixm 'XFLOAT option'
.ixm 'options' 'XFLOAT'
:cmt. .ixm 'NOXFLOAT option'
:cmt. .ixm 'options' 'NOXFLOAT'
.ix 'increased precision'
The "xfloat" option specifies that all REAL variables are treated as
if they had been declared as "DOUBLE PRECISION".
This effectively increases the precision of REAL variables.
Note that the "xfloat" option has implications on the alignment of
variables in common blocks.
The default option is "noxfloat".
.*
.do end
.*
.note [NO]Xline
.ixm 'XLINE option'
.ixm 'options' 'XLINE'
:cmt. .ixm 'NOXLINE option'
:cmt. .ixm 'options' 'NOXLINE'
The "xline" option informs the &cmpname compiler to extend the last
column of the statement portion of a line to column 132.
The default is 72.
.*
.if '&cmpclass' eq 'load-n-go' .do begin
.*
.note [NO]XType
.ixm 'XTYPE option'
.ixm 'options' 'XTYPE'
:cmt. .ixm 'NOXTYPE option'
:cmt. .ixm 'options' 'NOXTYPE'
The "xtype" option is used to indicate that all output to unit 6
should be written to the terminal instead of the listing file.
If "noxtype" is specified, all output to unit 6 will appear following
the source program listing.
The connection of unit 6 to the terminal or listing file using the
"xtype" option may be overridden by a preconnection specification or a
FORTRAN
.kw OPEN
statement.
The default is "xtype".
.*
.do end
.*
.endnote
.*