1WMC(1)                      Wine Developers Manual                      WMC(1)
2
3
4

NAME

6       wmc - Wine Message Compiler
7

SYNOPSIS

9       wmc [options] [inputfile]
10

DESCRIPTION

12       wmc  compiles messages from inputfile into FormatMessage[AW] compatible
13       format encapsulated in a resourcescript format.  wmc outputs  the  data
14       either  in  a  standard  .bin  formatted  binary file, or can generated
15       inline resource data.
16
17       wmc takes only one inputfile as argument (see BUGS). The inputfile nor‐
18       mally  has  extension .mc. The messages are read from standard input if
19       no inputfile is given. If the outputfile is not specified with -o, then
20       wmc will write the output to inputfile.{rc,h}.  The outputfile is named
21       wmc.tab.{rc,h} if no inputfile was given.
22

OPTIONS

24       -B x   Set output byte-order x={n[ative], l[ittle], b[ig]}. Default  is
25              n[ative].
26
27       -c     Set 'custom-bit' in message-code values.
28
29       -d     NON-FUNCTIONAL; Use decimal values in output
30
31       -D     Set  debug  flag.  This  results  is a parser trace and a lot of
32              extra messages.
33
34       -h, --help
35              Print an informative usage message and exits.
36
37       -H file
38              Write headerfile to file. Default is inputfile.h.
39
40       -i     Inline messagetable(s). This option skips the generation of  all
41              .bin  files and writes all output into the .rc file. This encod‐
42              ing is parsable with wrc(1).
43
44       -o, --output=file
45              Output to file. Default is inputfile.rc.
46
47       -O, --output-format=format
48              Set the output format. Supported formats are rc  (the  default),
49              res, and pot.
50
51       -P, --po-dir=directory
52              Enable the generation of resource translations based on po files
53              loaded from the specified directory. That directory must  follow
54              the  gettext  convention,  in particular in must contain one .po
55              file for each language, and a LINGUAS file listing the available
56              languages.
57
58       -u     Assume that the inputfile is in unicode.
59
60       -U     Write resource output in unicode formatted messagetable(s).
61
62       -v     Show all supported codepages and languages.
63
64       -V, --version
65              Print version end exit.
66
67       -W, --pedantic
68              Enable pedantic warnings.
69

EXTENSIONS

71       The  original  syntax  is  extended to support codepages more smoothly.
72       Normally, codepages are based on the DOS  codepage  from  the  language
73       setting. The original syntax only allows the destination codepage to be
74       set. However, this is not enough for non-DOS systems which do  not  use
75       unicode source-files.
76
77       A  new  keyword  Codepages  is  introduced to set both input and output
78       codepages to anything one wants for each language. The syntax is  simi‐
79       lar to the other constructs:
80
81       Codepages '=' '(' language '=' cpin ':' cpout ... ')'
82
83       The language is the numerical language-ID or the alias set with Langua‐
84       geNames. The input codepage cpin and  output  codepage  cpout  are  the
85       numerical codepage IDs. There can be multiple mappings within the defi‐
86       nition and the definition may occur more than once.
87

AUTHORS

89       wmc was written by Bertho A. Stultiens.
90

BUGS

92       The message compiler should be able to have multiple  input  files  and
93       combine  them  into one output file. This would enable the splitting of
94       languages into separate files.
95
96       Unicode detection of the input is suboptimal,  to  say  the  least.  It
97       should recognize byte order marks (BOM) and decide what to do.
98
99       Decimal  output  is completely lacking. Don't know whether it should be
100       implemented because it is a, well, non-informative format change. It is
101       recognized on the commandline for some form of compatibility.
102
103       Bugs can be reported on the Wine bug tracker https://bugs.winehq.org⟩.
104

AVAILABILITY

106       wmc  is  part  of  the  Wine  distribution,  which is available through
107       WineHQ, the Wine development headquarters https://www.winehq.org/⟩.
108

SEE ALSO

110       wine(1), wrc(1),
111       Wine documentation and support https://www.winehq.org/help⟩.
112
113
114
115Wine 4.21                        October 2005                           WMC(1)
Impressum