| .TH WMC 1 "October 2005" "@PACKAGE_STRING@" "Wine Developers Manual" | |
| .SH NAME | |
| wmc \- Wine Message Compiler | |
| .SH SYNOPSIS | |
| .B wmc | |
| .RI [ 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 \fI.bin\fR formatted binary | |
| file, or can generated inline resource data. | |
| .PP | |
| .B wmc | |
| takes only one \fIinputfile\fR as argument (see \fBBUGS\fR). The | |
| \fIinputfile\fR normally has extension \fI.mc\fR. The messages are read from | |
| standard input if no inputfile is given. If the outputfile is not specified | |
| with \fB-o\fR, then \fBwmc\fR will write the output to \fIinputfile.{rc,h}\fR. | |
| The outputfile is named \fIwmc.tab.{rc,h}\fR if no inputfile was given. | |
| .SH OPTIONS | |
| .TP | |
| .BI \-B\ x | |
| Set output byte-order x={n[ative], l[ittle], b[ig]}. Default is n[ative]. | |
| .TP | |
| .B \-c | |
| Set 'custom-bit' in message-code values. | |
| .TP | |
| .B \-d | |
| NON-FUNCTIONAL; Use decimal values in output | |
| .TP | |
| .B \-D | |
| Set debug flag. This results is a parser trace and a lot of extra messages. | |
| .TP | |
| .BR \-h ,\ \-\-help | |
| Print an informative usage message and exits. | |
| .TP | |
| .BI \-H\ file | |
| Write headerfile to \fIfile\fR. Default is \fIinputfile.h\fR. | |
| .TP | |
| .B \-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 | |
| .BR \-o ,\ \-\-output =\fIfile | |
| Output to \fIfile\fR. Default is \fIinputfile.rc\fR. | |
| .TP | |
| .BR \-O ,\ \-\-output\-format =\fIformat | |
| Set the output format. Supported formats are \fBrc\fR (the default), | |
| \fBres\fR, and \fBpot\fR. | |
| .TP | |
| .BR \-P ,\ \-\-po-dir =\fIdirectory | |
| Enable the generation of resource translations based on po files | |
| loaded from the specified directory. That directory must follow the | |
| gettext convention, in particular in must contain one \fI.po\fR file for | |
| each language, and a LINGUAS file listing the available languages. | |
| .TP | |
| .B \-u | |
| Assume that the inputfile is in unicode. | |
| .TP | |
| .B \-U | |
| Write resource output in unicode formatted messagetable(s). | |
| .TP | |
| .B \-v | |
| Show all supported codepages and languages. | |
| .TP | |
| .BR \-V ,\ \-\-version | |
| Print version end exit. | |
| .TP | |
| .BR \-W ,\ \-\-pedantic | |
| 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 \fBCodepages\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 mappings | |
| 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 input files and combine | |
| them into one output file. 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. | |
| .PP | |
| Bugs can be reported on the | |
| .UR http://bugs.winehq.org | |
| .B Wine bug tracker | |
| .UE . | |
| .SH AVAILABILITY | |
| .B wmc | |
| is part of the Wine distribution, which is available through WineHQ, | |
| the | |
| .UR http://www.winehq.org/ | |
| .B Wine development headquarters | |
| .UE . | |
| .SH "SEE ALSO" | |
| .BR wine (1), | |
| .BR wrc (1), | |
| .br | |
| .UR http://www.winehq.org/help | |
| .B Wine documentation and support | |
| .UE . |