| .\" -*- nroff -*- |
| .TH WMC 1 "October 2005" "@PACKAGE_STRING@" "Wine Developers Manual" |
| .SH NAME |
| wrc \- Wine Message Compiler |
| .SH SYNOPSIS |
| .BI "wmc " "[options] " "[inputfile]" |
| .SH DESCRIPTION |
| .B wmc |
| compiles messages from |
| .B inputfile |
| into FormatMessage[AW] compatible format encapsulated in a resourcescript |
| format. |
| .B wmc |
| outputs the data either in a standard \fB.bin\fR formatted binary |
| file, or can generated inline resource data. |
| .PP |
| .B wmc |
| takes only one \fBinputfile\fR as argument (see \fBBUGS\fR). The |
| \fBinputfile\fR normally has extension \fB.mc\fR. The messages are read from |
| standard input if no inputfile is given. If the outputfile is not specified |
| with \fI-o\fR, then \fBwmc\fR will write the output to \fBinputfile.{rc,h}\fR. |
| The outputfile is named \fBwmc.tab.{rc,h}\fR if no inputfile was given. |
| .SH OPTIONS |
| .TP |
| .I \-B x |
| Set output byte-order x={n[ative], l[ittle], b[ig]}. Default is n[ative]. |
| .TP |
| .I \-c |
| Set 'custom-bit' in message-code values. |
| .TP |
| .I \-d |
| NON-FUNCTIONAL; Use decimal values in output |
| .TP |
| .I \-D |
| Set debug flag. This results is a parser trace and a lot of extra messages. |
| .TP |
| .I \-h |
| Print an informative usage message. |
| .TP |
| .I \-H file |
| Write headerfile to \fIfile\fR. Default is \fIinputfile.h\fR. |
| .TP |
| .I \-i |
| Inline messagetable(s). This option skips the generation of all \fI.bin\fR files |
| and writes all output into the \fI.rc\fR file. This encoding is parsable with |
| wrc(1). |
| .TP |
| .I \-o file |
| Output to \fIfile\fR. Default is \fIinputfile.rc\fR. |
| .TP |
| .I \-u |
| Assume that the inputfile is in unicode. |
| .TP |
| .I \-U |
| Write resource output in unicode formatted messagetable(s). |
| .TP |
| .I \-v |
| Show all supported codepages and languages. |
| .TP |
| .I \-V |
| Print version end exit. |
| .TP |
| .I \-W |
| Enable pedantic warnings. |
| .SH 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. |
| .PP |
| A new keyword \fICodepages\fR is introduced to set both input and output |
| codepages to anything one wants for each language. The syntax is similar to |
| the other constructs: |
| .PP |
| Codepages '=' '(' language '=' cpin ':' cpout ... ')' |
| .PP |
| The \fIlanguage\fR is the numerical language\-ID or the alias set with |
| LanguageNames. The input\-codepage \fIcpin\fR and output\-codepage |
| \fIcpout\fR are the numerical codepage\-IDs. There can be multiple mapping |
| within the definition and the definition may occur more than once. |
| .SH AUTHORS |
| .B wmc |
| was written by Bertho A. Stultiens. |
| .SH 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. |
| .PP |
| Unicode detection of the input is suboptimal, to say the least. It should |
| recognize byte\-order\-marks (BOM) and decide what to do. |
| .PP |
| 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. |
| .SH AVAILABILITY |
| .B wmc |
| is part of the wine distribution, which is available through |
| WineHQ, the |
| .B wine |
| development headquarters, at |
| .I http://www.winehq.org/. |
| .SH "SEE ALSO" |
| .BR wine (1), |
| .BR wrc (1) |