WMC(1) Wine Developers Manual WMC(1)
NAME
wrc - Wine Message Compiler
SYNOPSIS
wmc [options] [inputfile]
DESCRIPTION
wmc compiles messages from inputfile into FormatMessage[AW] compatible format encapsulated in a resourcescript format. wmc outputs the
data either in a standard .bin formatted binary file, or can generated inline resource data.
wmc takes only one inputfile as argument (see BUGS). The inputfile normally has extension .mc. The messages are read from standard input if
no inputfile is given. If the outputfile is not specified with -o, then wmc will write the output to inputfile.{rc,h}. The outputfile is
named wmc.tab.{rc,h} if no inputfile was given.
OPTIONS
-B x Set output byte-order x={n[ative], l[ittle], b[ig]}. Default is n[ative].
-c Set 'custom-bit' in message-code values.
-d NON-FUNCTIONAL; Use decimal values in output
-D Set debug flag. This results is a parser trace and a lot of extra messages.
-h Print an informative usage message.
-H file
Write headerfile to file. Default is inputfile.h.
-i Inline messagetable(s). This option skips the generation of all .bin files and writes all output into the .rc file. This encoding is
parsable with wrc(1).
-o file
Output to file. Default is inputfile.rc.
-u Assume that the inputfile is in unicode.
-U Write resource output in unicode formatted messagetable(s).
-v Show all supported codepages and languages.
-V Print version end exit.
-W Enable pedantic warnings.
EXTENSIONS
The original syntax is extended to support codepages more smoothly. Normally, codepages are based on the DOS-codepage from the language
setting. The original syntax only allows the destination codepage to be set. However, this is not enough for non-DOS systems which do not
use unicode source-files.
A new keyword Codepages is introduced to set both input and output codepages to anything one wants for each language. The syntax is similar
to the other constructs:
Codepages '=' '(' language '=' cpin ':' cpout ... ')'
The language is the numerical language-ID or the alias set with LanguageNames. The input-codepage cpin and output-codepage cpout are the
numerical codepage-IDs. There can be multiple mapping within the definition and the definition may occur more than once.
AUTHORS
wmc was written by Bertho A. Stultiens.
BUGS
The message compiler should be able to have multiple inputfiles and combine them into one outputfile. This would enable the splitting of
languages into separate files.
Unicode detection of the input is suboptimal, to say the least. It should recognize byte-order-marks (BOM) and decide what to do.
Decimal output is completely lacking. Don't know whether it should be implemented because it is a, well, non-informative format change. It
is recognized on the commandline for some form of compatibility.
AVAILABILITY
wmc is part of the wine distribution, which is available through WineHQ, the wine development headquarters, at http://www.winehq.org/.
SEE ALSO
wine(1), wrc(1)
Wine 1.2-rc6 October 2005 WMC(1)
Check Out this Related Man Page
WRC(1) Wine Developers Manual WRC(1)
NAME
wrc - Wine Resource Compiler
SYNOPSIS
wrc [options] [inputfiles]
DESCRIPTION
wrc compiles resources from inputfile into win16 and win32 compatible binary format.
The source-file is preprocessed with a builtin ANSI-C compatible preprocessor before the resources are compiled. See PREPROCESSOR below.
wrc takes a series of inputfile as argument. The resources are read from standard input if no inputfile is given. If the output file is not
specified with -o, then wrc will write the output to inputfile.res with .rc stripped, or to wrc.tab.res if no inputfile was given.
OPTIONS
--debug=nn
Set debug level to nn. The value is a bitmask consisting of 1=verbose, 2=dump internals, 4=resource parser trace, 8=preprocessor
messages, 16=preprocessor scanner and 32=preprocessor parser trace.
--endianess=e
Win32 only; set output byte-ordering, where e is one of n[ative], l[ittle] or b[ig]. Only resources in source-form can be reorderd.
Native ordering depends on the system on which wrc was built. You can see the native ordering by typing wrc -h.
-D, --define=id[=val]
Define preprocessor identifier id to (optionally) value val. See also PREPROCESSOR below.
-E Preprocess only. The output is written to standard output if no outputfile was selected. The output is compatible with what gcc
would generate.
-F, --target
Ignored for compatibility with windres.
-h, --help
Prints a summary message and exits.
-i, --input=file
The name of the input file. If this option is not used, then wrc will use the first non-option argument as the input file name. If
there are no non-option arguments, then wrc will read from standard input.
-I, --include-dir=file
Add path to include search directories. Path may contain multiple directories, separated with ':'. It is allowed to specify -I mul-
tiple times. Include files are searched in the order in with the -I options were specified.
The search is compatible with gcc, in which '<>' quoted filenames are searched exclusively via the -I set path, whereas the '""'
quoted filenames are first tried to be opened in the current directory. Also resource statements with file references are located in
the same way.
-J, --input-format=format
Sets the input format. Valid options are 'rc' or 'rc16'. Setting the input to 'rc16' disables the recognition of win32 keywords.
-l, --language=lan
Set default language to lan. Default is the neutral language 0 (i.e. "LANGUAGE 0, 0").
--nostdinc
Do not search the standard include path, look for include files only in the directories explicitly specified with the -I option.
--no-use-temp-file
Ignored for compatibility with windres.
-o, -fo, --output=file
Write output to file. Default is inputfile.res with .rc stripped or wrc.tab.res if input is read from standard input.
-O, --output-format=format
Sets the output format. The supported formats are 'res' and 'res16'. If this option is not specified, format defaults to 'res'.
--pedantic
Enable pedantic warnings. Notably redefinition of #define statements can be discovered with this option.
-r Ignored for compatibility with rc.
--preprocessor=program
This option may be used to specify the preprocessor to use, including any leading arguments. If not specified, wrc uses its builtin
processor. To disable preprocessing, use --preprocessor=cat.
-U, --undefine=id
Undefine preprocessor identifier id. Please note that only macros defined up to this point are undefined by this command. However,
these include the special macros defined automatically by wrc. See also PREPROCESSOR below.
--use-temp-file
Ignored for compatibility with windres.
-v, --verbose
Turns on verbose mode (equivalent to -d 1).
--version
Print version end exit.
PREPROCESSOR
The preprocessor is ANSI-C compatible with some of the extensions of the gcc preprocessor.
The preprocessor recognizes these directives: #include, #define (both simple and macro), #undef, #if, #ifdef, #ifndef, #elif, #else,
#endif, #error, #warning, #line, # (both null- and line-directive), #pragma (ignored), #ident (ignored).
The preprocessor sets by default several defines:
RC_INVOKED set to 1
__WRC__ Major version of wrc
__WRC_MINOR__ Minor version of wrc
__WRC_PATCHLEVEL__ Patch level
Win32 compilation mode also sets __WIN32__ to 1 and __FLAT__ to 1.
Special macros __FILE__, __LINE__, __TIME__ and __DATE__ are also recognized and expand to their respective equivalent.
LANGUAGE SUPPORT
Language, version and characteristics can be bound to all resource types that have inline data, such as RCDATA. This is an extension to Mi-
crosoft's resource compiler, which lacks this support completely. Only VERSIONINFO cannot have version and characteristics attached, but
languages are propagated properly if you declare it correctly before the VERSIONINFO resource starts.
Example:
1 RCDATA DISCARDABLE
LANGUAGE 1, 0
VERSION 312
CHARACTERISTICS 876
{
1, 2, 3, 4, 5, "and whatever more data you want"
'00 01 02 03 04 05 06 07 08'
}
AUTHORS
wrc was written by Bertho A. Stultiens and is a nearly complete rewrite of the first wine resource compiler (1994) by Martin von Loewis.
Additional resource-types were contributed Ulrich Czekalla and Albert den Haan. Many cleanups by Dimitrie O. Paun in 2002-2003. Bugfixes
have been contributed by many Wine developers.
BUGS
- The preprocessor recognizes variable argument macros, but does not expanded them correctly.
- Error reporting should be more precise, as currently the column and line number reported are those of the next token.
- Default memory options should differ between win16 and win32.
There is no support for:
- RT_DLGINCLUDE, RT_VXD, RT_PLUGPLAY and RT_HTML (unknown format)
- PUSHBOX control is unsupported due to lack of original functionality.
Fonts are parsed and generated, but there is no support for the generation of the FONTDIR yet. The user must supply the FONTDIR resource in
the source to match the FONT resources.
AVAILABILITY
wrc is part of the Wine distribution, which is available through WineHQ, the Wine development headquarters, at http://www.winehq.org/.
SEE ALSO
wine(1)
Wine 1.2-rc6 October 2005 WRC(1)