1 .TH WMC 1 "October 2005" "@PACKAGE_STRING@" "Wine Developers Manual"
3 wmc \- Wine Message Compiler
6 .RI [ options ]\ [ inputfile ]
11 into FormatMessage[AW] compatible format encapsulated in a resourcescript
14 outputs the data either in a standard \fI.bin\fR formatted binary
15 file, or can generated inline resource data.
18 takes only one \fIinputfile\fR as argument (see \fBBUGS\fR). The
19 \fIinputfile\fR normally has extension \fI.mc\fR. The messages are read from
20 standard input if no inputfile is given. If the outputfile is not specified
21 with \fB-o\fR, then \fBwmc\fR will write the output to \fIinputfile.{rc,h}\fR.
22 The outputfile is named \fIwmc.tab.{rc,h}\fR if no inputfile was given.
26 Set output byte-order x={n[ative], l[ittle], b[ig]}. Default is n[ative].
29 Set 'custom-bit' in message-code values.
32 NON-FUNCTIONAL; Use decimal values in output
35 Set debug flag. This results is a parser trace and a lot of extra messages.
38 Print an informative usage message and exits.
41 Write headerfile to \fIfile\fR. Default is \fIinputfile.h\fR.
44 Inline messagetable(s). This option skips the generation of all \fI.bin\fR files
45 and writes all output into the \fI.rc\fR file. This encoding is parsable with
48 .BI \-\-nls-dir= directory
49 Specify the directory to search for the NLS files containing the
50 codepage mapping tables.
52 .BR \-o ,\ \-\-output =\fIfile
53 Output to \fIfile\fR. Default is \fIinputfile.rc\fR.
55 .BR \-O ,\ \-\-output\-format =\fIformat
56 Set the output format. Supported formats are \fBrc\fR (the default),
57 \fBres\fR, and \fBpot\fR.
59 .BR \-P ,\ \-\-po-dir =\fIdirectory
60 Enable the generation of resource translations based on po files
61 loaded from the specified directory. That directory must follow the
62 gettext convention, in particular in must contain one \fI.po\fR file for
63 each language, and a LINGUAS file listing the available languages.
66 Assume that the input file is in Unicode or UTF-8 format and skip
70 Show all supported codepages and languages.
72 .BR \-V ,\ \-\-version
73 Print version end exit.
75 .BR \-W ,\ \-\-pedantic
76 Enable pedantic warnings.
78 The original syntax is extended to support codepages more smoothly. Normally,
79 codepages are based on the DOS codepage from the language setting. The
80 original syntax only allows the destination codepage to be set. However, this
81 is not enough for non\-DOS systems which do not use unicode source-files.
83 A new keyword \fBCodepages\fR is introduced to set both input and output
84 codepages to anything one wants for each language. The syntax is similar to
87 Codepages '=' '(' language '=' cpin ':' cpout ... ')'
89 The \fIlanguage\fR is the numerical language\-ID or the alias set with
90 LanguageNames. The input codepage \fIcpin\fR and output codepage
91 \fIcpout\fR are the numerical codepage IDs. There can be multiple mappings
92 within the definition and the definition may occur more than once.
95 was written by Bertho A. Stultiens.
97 The message compiler should be able to have multiple input files and combine
98 them into one output file. This would enable the splitting of languages into
101 Decimal output is completely lacking. Don't know whether it should be
102 implemented because it is a, well, non-informative format change. It is
103 recognized on the commandline for some form of compatibility.
105 Bugs can be reported on the
106 .UR https://bugs.winehq.org
111 is part of the Wine distribution, which is available through WineHQ,
113 .UR https://www.winehq.org/
114 .B Wine development headquarters
120 .UR https://www.winehq.org/help
121 .B Wine documentation and support