rfropt.gml

来自「开放源码的编译器open watcom 1.6.0版的源代码」· GML 代码 · 共 764 行 · 第 1/2 页

&decvax.
    /MAIL=file-name
:EXMP.
:PC.
The
:I2 refid='gropt'.mailmerge
:I1.mailmerge option
MAILMERGE option specifies a
file containing symbol substitution values or the name of a WATFILE database.
This option may be used to create a number of similar documents, such
as a form letter mailing.
The &WGML. processor will inspect the file to determine the file type
(WATFILE or symbol values).
The following two subsections describe the processing of these files.
:H4.WATFILE Database File
:P.
Each field value in a WATFILE input record is assigned to a symbol
name created from the WATFILE field name.
If the field name contains characters which are invalid in GML symbol
names, the characters up to the invalid character are used.
:P.
If the WATFILE file contains the following data:
:XMP.
define name                 = 10   L
define addr1                =  6   L
define addr2                =  5   L
bye
John Doe  StreetCity
:eXMP.
:PC.then the three values could be used in the following way:
:XMP.
&gml.ADDRESS.
&gml.ALINE.&amp.name.
&gml.ALINE.&amp.addr1.
&gml.ALINE.&amp.addr2.
&gml.eADDRESS.
:eXMP.
:H4.Values File
:P.
Each record in the values file must contain
the same number of symbol values.
The document will be produced once for
each record in the file.
If a layout is specified, it is only processed the first
time the document is processed.
:P.
Symbol values are separated by commas.
Each value may be enclosed in
single (') or double (") quotes.
The quotation
marks surrounding the text are not
part of the symbol value. If a
quotation mark of the same type
used to delimit the symbol value is to
be part of the symbol text, it can
be entered by specifying the quote
character twice. Only one quote
character will appear in the resulting
symbol value. A symbol value must be quoted
if it contains a comma.
:P.
The blanks outside quotations, or if the value is not quoted, the
blanks before the first and after
the last nonblank character, are not
considered part of the symbol value.
For example, <,,>, <,\b\b\b,>,
<,end_of_record>, or empty records
all specify empty symbol values.
:P.
Each symbol value in an input record is assigned to a special symbol
name.
The values are assigned to VALUE1, VALUE2, etc.
For example, if the values file contains the following,
:XMP.
"John Doe","13 Country Lane","Canada"
:eXMP.
:PC.then the three values could be used in the following way:
:XMP.
&gml.ADDRESS.
&gml.ALINE.&amp.value1.
&gml.ALINE.&amp.value2.
&gml.ALINE.&amp.value3.
&gml.eADDRESS.
:eXMP.
:H3.OUTput
:XMP.
&ibmvm. and &ibmpc.
    OUT temp1
&decvax.
    /OUT=temp1
:EXMP.
:PC.
The
:I2 refid='gropt'.output
:I1.output option
output will go to the specified file name instead of the
default output file.
The default output file name is determined by the device selected
on the command line.
In some cases the output from &WGML. is sent directly
to the device, while in other cases the output is sent
to a disk file.
:P.
If the file name component of the output name is an asterisk,
the name of the document is used.
For example, an output file specification of &mono.*.ps&emono.
when the document name is &mono.manual.gml&emono. will produce
&mono.manual.ps&emono. as the output file.
Refer to :HDREF refid='devout'. for more information.
:H3 id='runpass'.PASSes
:XMP.
&ibmvm. and &ibmpc.
    PASS 2
&decvax.
    /PASS=2
:EXMP.
:PC.
In
:I2 refid='gropt'.passes
:I1.passes option
some cases &WGML.
must process a document more than once to properly
produce the output document.
The value of the passes option is
the number of times &WGML. must process the document.
&WGML. will issue a warning message if more passes are necessary.
The default passes value is one.
:H3.PAUSE/NOPause
:XMP.
&ibmvm. and &ibmpc.
    PAUSE
    NOP
&decvax.
    /PAUSE
    /NOP
:EXMP.
:PC.
When
:I2 refid='gropt'.pause
:I1.pause option
:I2 refid='gropt'.nopause
:I1.nopause option
some of the output devices are selected, information
messages are displayed and a response from the keyboard is
requested.
An example of this is the terminal device which pauses at the
bottom of the screen to prevent the output from being scrolled
off the screen.
The NOPAUSE option suppresses the display of information and
requests for keyboard input.
PAUSE is the default option.
:H3.PROCess
:XMP.
&ibmvm. and &ibmpc.
    PROC x2700
&decvax.
    /PROC=x2700
:EXMP.
:PC.
The
:I2 refid='gropt'.process
:I1.process option
specified name is an alternate condition for the :HP2.&gml.psc:eHP2. tag.
:I2 refid='etpsc'.psc
:H3.QUIET/NOQuiet
:XMP.
&ibmvm. and &ibmpc.
    QUIET
    NOQ
&decvax.
    /QUIET
    /NOQ
:EXMP.
:PC.
The
:I2 refid='gropt'.quiet
:I1.quiet option
:I2 refid='gropt'.noquiet
:I1.noquiet option
quiet option sets the variable &amp.SYSQUIET. to the value "ON".
Noquiet will set the value to "OFF".
:H3.RESETscreen
:XMP.
&ibmvm. and &ibmpc.
    RESET
&decvax.
    /RESET
:EXMP.
:PC.
The
:I2 refid='gropt'.resetscreen
:I1.resetscreen option
RESETSCREEN option clears the screen before document processing
begins and queries the user when the formatting is complete.
Active only when the screen is used in line mode, this option
is intended for use when &WGML. is invoked from an application program.
:H3.SCRipt/NOSCRipt
:XMP.
&ibmvm. and &ibmpc.
    SCR
    NOSCR
&decvax.
    /SCR
    /NOSCR
:EXMP.
:PC.
The
:I2 refid='gropt'.script
:I1.script option
:I2 refid='gropt'.noscript
:I1.noscript option
SCRIPT option enables recognition of Script control words and the
line separator character.
The default option NOSCRIPT will cause these values to be treated as text.
:H3.SETsymbol
:XMP.
&ibmvm. and &ibmpc.
    SET processor WGML
&decvax.
    /SET=(processor,WGML)
:EXMP.
:PC.
The
:I2 refid='gropt'.setsymbol
:I1.setsymbol option
SETSYMBOL option requires two values.
The first value is the name of the symbol to be set.
The second value is the character string that is to be
assigned to the specified symbol name.
This option is equivalent to using the :HP2.&gml.SET:eHP2.
tag at the beginning of the source document.
Refer to :HDREF refid='symsub'. and :HDREF refid='settag'..
:H3.STATistics/NOSTATistics
:XMP.
&ibmvm. and &ibmpc.
    STAT
    NOSTAT
&decvax.
    /STAT
    /NOSTAT
:EXMP.
:PC.
Statistics
:I2 refid='gropt'.statistics
:I1.statistics option
about the document are displayed
after document processing is completed when in line mode,
and during the document processing when in full screen mode.
Examples of the type of information displayed are the number of input
lines processed, the number of include files, and the number
of pages produced.
NOSTATISTICS is the default when in line mode (see :HDREF refid=rfrlino.).
:H3.TERSE/VERBose
:XMP.
&ibmvm. and &ibmpc.
    TERSE
    VERB
&decvax.
    /TERSE
    /VERB
:EXMP.
:PC.
Headings
:I2 refid='gropt'.terse
:I2 refid='gropt'.verbose
:I1.terse option
:I1.verbose option
are not displayed on the terminal as the document is
processed when the TERSE option is specified.
Headings
are displayed on the terminal as the document is
processed when the VERBOSE option is specified.
TERSE is the default when in line mode (see :HDREF refid=rfrlino.).
:H3 id='rfrtoo'.TO
:XMP.
&ibmvm. and &ibmpc.
    TO page-number
&decvax.
    /TO=page-number
:EXMP.
:PC.
The
:I2 refid='gropt'.to
:I1.to option
TO option
will direct &WGML. to stop printing the document
at the specified page number within the body of the document.
The number is specified as an integer, and does not depend on
the format the numbers on the output pages (or whether or not they
are even printed on the page).
For example, if the page numbers are formatted as roman numerals,
the page number you specify would be "6", not "vi".
See :HDREF refid=rfrfroo. for more information.
:H3.VALUESet
:XMP.
&ibmvm. and &ibmpc.
    VALUES file-name
&decvax.
    /VALUES=file-name
:EXMP.
:PC.
The
:I2 refid='gropt'.valueset
:I1.valueset option
VALUESET option is an equivalent name for
the MAILMERGE option.
See :HDREF refid='mailmrg'. for more information.
:H3.WAIT/NOWAIT
:XMP.
&ibmvm. and &ibmpc.
    WAIT
    NOWAIT
&decvax.
    /WAIT
    /NOWAIT
:EXMP.
:PC.
Certain
:I2 refid='gropt'.wait
:I1.wait option
:I2 refid='gropt'.nowait
:I1.nowait option
errors (such as device not ready) will result in a query from
&WGML. about continuing with the document processing.
&WGML. also waits after processing the document
when in not line mode (see :HDREF refid='rfrlino'.).
The default option WAIT enables these queries.
The option NOWAIT will suppress the query.
:H3.WARNing/NOWARNing
:XMP.
&ibmvm. and &ibmpc.
    WARN
    NOWARN
&decvax.
    /WARN
    /NOWARN
:EXMP.
:PC.
The
:I2 refid='gropt'.warning
:I2 refid='gropt'.nowarning
:I1.warning option
:I1.nowarning option
WARNING option(the default) causes
GML warning messages about possible error conditions
to be displayed on the screen.
Processing of the document is not halted when a warning
message is displayed.
&WGML. warnings about possible error situations and information messages
are not displayed on the screen when the NOWARNING option is specified.
:H3.WSCRipt
:XMP.
&ibmvm. and &ibmpc.
    WSCR
&decvax.
    /WSCR
:EXMP.
:PC.
The
:I2 refid='gropt'.wscript
:I1.wscript option
WSCRIPT option enables recognition of Script control words and the
line separator character.
In addition, it enables several WATCOM extensions over Waterloo Script.
The extensions are:
:OL.
:LI.Lines of input which
:UL.
:LI.are processed when concatenate is OFF
:LI.start with blank space
:LI.the blank space is followed by a GML tag that is not a continuation
:eUL.
have the blank space at the beginning of the line ignored.
:LI.When .CO OFF is set, lines which exceed the line length are
split into two lines.
:LI.Extra blanks between words are suppressed in concatenate mode.
:LI.Full and partial stops are recognized anywhere in the input line
if followed by a space.
:LI.If a macro for .LB, .LT, .NL, or .BL is not defined, a break is
not implicitly performed.
:eOL.