wrc.gml

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

No text is displayed as the &wrcname runs except for warning and
error messages.
.*
.point &sw.30
.ix 'resource compiler options' '30'
Marks the executable file as being able to run on Windows 3.0 or
Windows 3.1.
By default, &wrccmdup marks the executable file as able to run on
Windows 3.1 only. This option affects pass two only.
.*
.point &sw.31
.ix 'resource compiler options' '31'
Marks the executable file as being able to run on Windows 3.1 only.
This is the default setting. This option affects pass two only.
.*
.point &sw.ad
.ix 'resource compiler options' 'ad'
Allows the use of the WMAKE .AUTODEPEND directive with your
.fi &sysper.RES
files.
If you do the first and second passes separately and use this option,
you should specify it for both passes. This option may not be used
with the -zm switch.
.*
.point &sw.DNAME=value
.ix 'resource compiler options' 'D'
Defines a macro NAME.  This is the same as adding the line
.millust begin
#define NAME    value
.millust end
to the top of your resouce script file.  If value is not specified
then a compiler generated value is provided.  This option affects pass
one only.
.*
.point &sw.bt=<target>
.ix 'resource compiler options' 'bt'
This is the build target directive.
It is used to specify whether you are building a resource file for
Win16, Win32 or OS/2.
The target may be one of the following:
.begpoint
.point windows
build a Win16 resource file (default for the DOS-hosted
resource compiler)
.point nt
build a Win32 resource file (default for the Win32-hosted
resource compiler)
.point os2
build an OS/2 resource file (default for the OS/2-hosted
resource compiler)
.endpoint
.np
This option affects pass one only.  During pass two the target is
inferred from the format of the input files.
.*
.point &sw.e
Specifies that global memory is above the EMS line in a Windows 3.0
DLL.
This option has no effect with Windows 3.1, Win32 or OS/2. This option
affects pass two only.
.*
.point &sw.fe=name
Specifies a new name for the resulting executable file after the
resources are added to the executable.
.*
.point &sw.fo=name
Specifies the name of the output resource file (default is the name of
the
.fi &sysper.RC
file with a
.fi &sysper.RES
extension).
The option affects pass one only.
.*
.point &sw.fr=name
Specifies the name of an additional input resource file.
The option affects pass one only.
This option may be specified multiple times.
.*
.point &sw.i=path
Specifies an include path.
This include path is searched before the directories specified in the
.ev INCLUDE
environment variable.  This option affects pass one only.
.*
.point &sw.k
Disables the segment sorting feature (load optimization).
If this option is not specified, the &wrcname arranges all pre-load
segments and resources so that they are at the start of the
executable. This option has no effect on Win32 or OS/2. This option
affects pass two only.
.*
.point &sw.l
Mark the application as using LIM 3.2 EMS directly.
This option has no effect with Windows 3.1, Win32 or OS/2.
This option affects pass two only.
.*
.point &sw.m
Each instance of the application has its own EMS bank, when Windows is
running with EMS 4.0 (by default, all instances share the same EMS
bank). This option has no effect with Windows 3.1, Win32 or OS/2.
This option affects pass two only.
.*
.point &sw.p
Mark a dynamic link library as a private DLL that is called by only one
application. This option has no effect with Windows 3.1, Win32 or OS/2.
This option affects pass two only.
.*
.point &sw.r
Only build the
.fi &sysper.RES
file.
This option is used when you do not want to add the compiled resources
to the executable file.  It prevents pass two from being performed.
.*
.point &sw.s{0,1,2}
Specifies the segment and resource sorting method.
Possible settings are:
.begpoint
.point 0:
No sorting, leave segments in the linker order.
.point 1:
Move preload segments to front and mark for fast load if possible.
.point 2:
Move preload, data, and non-discardable segments to front
and mark for fast load if possible (the default).
.endpoint
.np
This option has no effect with Win32 or OS/2. This option affects pass two
only.
.*
.point &sw.t
Marks the application as able to run in a protected-mode Windows
environment (standard mode or enhanced mode) only.
This option has no effect with Windows 3.1, Win32 or OS/2. This option
affects pass two only.
.*
.point &sw.v
This is a debugging option.
It causes &wrccmdup to print tokens as they are scanned during pass
one.
.*
.point &sw.v1
This is a debugging option.
It causes &wrccmdup to print grammar rules as they are reduced during
pass one.
.*
.point &sw.v2
This is a debugging option.
It causes &wrccmdup to print both tokens and grammar rules while pass
one is performed.
.*
.point &sw.x
This option causes &wrccmdup to ignore the
.ev INCLUDE
environment variable.
Normally, the &wrcname searches the directories specified in the
.ev INCLUDE
environment variable for files specified in a #include directive in
the
.fi &sysper.RC
file. This option affects pass one only.
.*
.point &sw.zk{0,1,2}
Strings contained in resources in the
.fi &sysper.RC
file are assumed to contain double byte characters from the
appropriate character sets.
Although these options allow strings to contain double byte
characters the names of resources in the resource script file must
contain only standard ASCII characters in the range 0-127 (inclusive).
This option affects pass one only.
Possible settings are:
.begpoint
.point 0:
(default) Kanji
.point 1:
Chinese/Taiwanese (for Windows only)
.point 2:
Korean (for Windows only)
.endpoint
.*
.point &sw.zm
This option causes &wrccmdup to output a Microsoft/IBM format
.fi &sysper.RES
file.
This is useful when using a dialog editor or other resource tool that
understands Microsoft or IBM
.fi &sysper.RES
files.  This option affects pass one only.
This option may not be specified when creating a
.fi &sysper.RES
file for Win32 (i.e., when the -bt=nt switch has been specified).
.*
.point &sw.zn
&wrccmdup will not pre-process the
.fi &sysper.RC
file if this option is specified.
This option affects pass one only.
.*
.endpoint
.*
.section *refid=wrcinfo Using the &wrcname
.*
.np
The command &wrccmdup is used to start the &wrcname..
The &wrcname may be used in a number of different ways:
.begbull
.bull
To compile a resource definition file and add the resulting resources
to the executable.
.np
&wrccmdup is used as follows to accomplish this:
.millust begin
&wrccmd [options] resource-definition-file [executable-file]
.millust end
.np
The resource-definition-file must not have the extension ".RES",
".EXE", ".SCR", ".DLL" or ".DRV". If no extension is specified for the
executable-file then ".EXE" is assumed. If executable-file is
specified without an extension but is terminated with a period (".")
then the default extension is not added. If the executable-file is not
specified then its value defaults to the filename specified for the
resource-definition-file with its extension changed to ".EXE".
.exam begin
&wrccmd life.rc
.exam end
.bull
To compile resources separately.
.np
This causes the &wrcname to create a
.fi &sysper.RES
file only.
&wrccmdup is used as follows to accomplish this:
.millust begin
&wrccmd -r [options] resource-definition-file [output-file]
.millust end
.np
The resource-definition-file must not have the extension ".RES",
".EXE", ".SCR", ".DLL" or ".DRV". If no extension is specified for the
output-file then ".RES" is assumed. If output-file is specified
without an extension but is terminated with a period (".") then the
default extension is not added. If the output-file is not specified
then its value defaults to the filename specified for the
resource-definition-file with its extension changed to ".RES".
.exam begin
&wrccmd -r -bt=nt life.rc
.exam end
.bull
To add a compiled resource file to an executable file.
.np
&wrccmdup is used as follows to accomplish this:
.millust begin
&wrccmd [options] resource-file [executable-file]
.millust end
.np
The resource-file must have the extension ".RES".  The defaults for
the executable-file parameter are the same as in the case of compiling
a resource definition file and adding the results to an executable.
.exam begin
&wrccmd life.res
.exam end
.bull
To add multiple compiled resource files to an executable file.
.np
&wrccmdup is used as follows to accomplish this:
.millust begin
&wrccmd [options] res-file [executable-file] -fr=res-file-2 ...
.millust end
.np
The resource files must have the extension ".RES".  The defaults for
the executable-file parameter are the same as in the case of compiling
a resource definition file and adding the results to an executable.
.exam begin
&wrccmd life.res life.exe -fr wave.res
.exam end
.bull
To compile an application that does not have a resource file.
.np
This is useful if you wish to set the Windows 3.x or Win32 version
number, or sort load the segments (Windows 3.x), or use any of the other
executable modifying features of &wrcname..
&wrccmdup is used as follows to accomplish this:
.millust begin
&wrccmd [options] executable-file
.millust end
.np
The file specified for executable-file specified must have a
".EXE", ".SCR", ".DLL" or ".DRV" extension.
.exam begin
&wrccmd -30 life.exe
.exam end
.endbull
.*
.section Warning and Error Messages
.*
.im wrcmacs
.im wrcerrs