OpenCores
URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [gnu-old/] [binutils-2.18.50/] [binutils/] [doc/] [windmc.1] - Blame information for rev 38

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 38 julius
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
2
.\"
3
.\" Standard preamble:
4
.\" ========================================================================
5
.de Sh \" Subsection heading
6
.br
7
.if t .Sp
8
.ne 5
9
.PP
10
\fB\\$1\fR
11
.PP
12
..
13
.de Sp \" Vertical space (when we can't use .PP)
14
.if t .sp .5v
15
.if n .sp
16
..
17
.de Vb \" Begin verbatim text
18
.ft CW
19
.nf
20
.ne \\$1
21
..
22
.de Ve \" End verbatim text
23
.ft R
24
.fi
25
..
26
.\" Set up some character translations and predefined strings.  \*(-- will
27
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28
.\" double quote, and \*(R" will give a right double quote.  | will give a
29
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
30
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
31
.\" expand to `' in nroff, nothing in troff, for use with C<>.
32
.tr \(*W-|\(bv\*(Tr
33
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34
.ie n \{\
35
.    ds -- \(*W-
36
.    ds PI pi
37
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
39
.    ds L" ""
40
.    ds R" ""
41
.    ds C` ""
42
.    ds C' ""
43
'br\}
44
.el\{\
45
.    ds -- \|\(em\|
46
.    ds PI \(*p
47
.    ds L" ``
48
.    ds R" ''
49
'br\}
50
.\"
51
.\" If the F register is turned on, we'll generate index entries on stderr for
52
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53
.\" entries marked with X<> in POD.  Of course, you'll have to process the
54
.\" output yourself in some meaningful fashion.
55
.if \nF \{\
56
.    de IX
57
.    tm Index:\\$1\t\\n%\t"\\$2"
58
..
59
.    nr % 0
60
.    rr F
61
.\}
62
.\"
63
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
64
.\" way too many mistakes in technical documents.
65
.hy 0
66
.\"
67
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
68
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
69
.    \" fudge factors for nroff and troff
70
.if n \{\
71
.    ds #H 0
72
.    ds #V .8m
73
.    ds #F .3m
74
.    ds #[ \f1
75
.    ds #] \fP
76
.\}
77
.if t \{\
78
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
79
.    ds #V .6m
80
.    ds #F 0
81
.    ds #[ \&
82
.    ds #] \&
83
.\}
84
.    \" simple accents for nroff and troff
85
.if n \{\
86
.    ds ' \&
87
.    ds ` \&
88
.    ds ^ \&
89
.    ds , \&
90
.    ds ~ ~
91
.    ds /
92
.\}
93
.if t \{\
94
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
95
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
96
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
97
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
98
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
99
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
100
.\}
101
.    \" troff and (daisy-wheel) nroff accents
102
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
103
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
104
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
105
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
106
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
107
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
108
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
109
.ds ae a\h'-(\w'a'u*4/10)'e
110
.ds Ae A\h'-(\w'A'u*4/10)'E
111
.    \" corrections for vroff
112
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
113
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
114
.    \" for low resolution devices (crt and lpr)
115
.if \n(.H>23 .if \n(.V>19 \
116
\{\
117
.    ds : e
118
.    ds 8 ss
119
.    ds o a
120
.    ds d- d\h'-1'\(ga
121
.    ds D- D\h'-1'\(hy
122
.    ds th \o'bp'
123
.    ds Th \o'LP'
124
.    ds ae ae
125
.    ds Ae AE
126
.\}
127
.rm #[ #] #H #V #F C
128
.\" ========================================================================
129
.\"
130
.IX Title "WINDMC 1"
131
.TH WINDMC 1 "2008-05-06" "binutils-2.18.50" "GNU Development Tools"
132
.SH "NAME"
133
windmc \- generates Windows message resources.
134
.SH "SYNOPSIS"
135
.IX Header "SYNOPSIS"
136
.SH "DESCRIPTION"
137
.IX Header "DESCRIPTION"
138
\&\fBwindmc\fR reads message definitions from an input file (.mc) and
139
translate them into a set of output files.  The output files may be of
140
four kinds:
141
.ie n .IP """h""" 4
142
.el .IP "\f(CWh\fR" 4
143
.IX Item "h"
144
A C header file containing the message definitions.
145
.ie n .IP """rc""" 4
146
.el .IP "\f(CWrc\fR" 4
147
.IX Item "rc"
148
A resource file compilable by the \fBwindres\fR tool.
149
.ie n .IP """bin""" 4
150
.el .IP "\f(CWbin\fR" 4
151
.IX Item "bin"
152
One or more binary files containing the resource data for a specific
153
message language.
154
.ie n .IP """dbg""" 4
155
.el .IP "\f(CWdbg\fR" 4
156
.IX Item "dbg"
157
A C include file that maps message id's to their symbolic name.
158
.PP
159
The exact description of these different formats is available in
160
documentation from Microsoft.
161
.PP
162
When \fBwindmc\fR converts from the \f(CW\*(C`mc\*(C'\fR format to the \f(CW\*(C`bin\*(C'\fR
163
format, \f(CW\*(C`rc\*(C'\fR, \f(CW\*(C`h\*(C'\fR, and optional \f(CW\*(C`dbg\*(C'\fR it is acting like the
164
Windows Message Compiler.
165
.SH "OPTIONS"
166
.IX Header "OPTIONS"
167
.IP "\fB\-a\fR" 4
168
.IX Item "-a"
169
.PD 0
170
.IP "\fB\-\-ascii_in\fR" 4
171
.IX Item "--ascii_in"
172
.PD
173
Specifies that the input file specified is \s-1ANSI\s0. This is the default
174
behaviour.
175
.IP "\fB\-A\fR" 4
176
.IX Item "-A"
177
.PD 0
178
.IP "\fB\-\-ascii_out\fR" 4
179
.IX Item "--ascii_out"
180
.PD
181
Specifies that messages in the output \f(CW\*(C`bin\*(C'\fR files should be in \s-1ANSI\s0
182
format.
183
.IP "\fB\-b\fR" 4
184
.IX Item "-b"
185
.PD 0
186
.IP "\fB\-\-binprefix\fR" 4
187
.IX Item "--binprefix"
188
.PD
189
Specifies that \f(CW\*(C`bin\*(C'\fR filenames should have to be prefixed by the
190
basename of the source file.
191
.IP "\fB\-c\fR" 4
192
.IX Item "-c"
193
.PD 0
194
.IP "\fB\-\-customflag\fR" 4
195
.IX Item "--customflag"
196
.PD
197
Sets the customer bit in all message id's.
198
.IP "\fB\-C\fR \fIcodepage\fR" 4
199
.IX Item "-C codepage"
200
.PD 0
201
.IP "\fB\-\-codepage_in\fR \fIcodepage\fR" 4
202
.IX Item "--codepage_in codepage"
203
.PD
204
Sets the default codepage to be used to convert input file to \s-1UTF16\s0. The
205
default is ocdepage 1252.
206
.IP "\fB\-d\fR" 4
207
.IX Item "-d"
208
.PD 0
209
.IP "\fB\-\-decimal_values\fR" 4
210
.IX Item "--decimal_values"
211
.PD
212
Outputs the constants in the header file in decimal. Default is using
213
hexadecimal output.
214
.IP "\fB\-e\fR \fIext\fR" 4
215
.IX Item "-e ext"
216
.PD 0
217
.IP "\fB\-\-extension\fR \fIext\fR" 4
218
.IX Item "--extension ext"
219
.PD
220
The extension for the header file. The default is .h extension.
221
.IP "\fB\-F\fR \fItarget\fR" 4
222
.IX Item "-F target"
223
.PD 0
224
.IP "\fB\-\-target\fR \fItarget\fR" 4
225
.IX Item "--target target"
226
.PD
227
Specify the \s-1BFD\s0 format to use for a bin file as output.  This
228
is a \s-1BFD\s0 target name; you can use the \fB\-\-help\fR option to see a list
229
of supported targets.  Normally \fBwindmc\fR will use the default
230
format, which is the first one listed by the \fB\-\-help\fR option.
231
.IP "\fB\-h\fR \fIpath\fR" 4
232
.IX Item "-h path"
233
.PD 0
234
.IP "\fB\-\-headerdir\fR \fIpath\fR" 4
235
.IX Item "--headerdir path"
236
.PD
237
The target directory of the generated header file. The default is the
238
current directory.
239
.IP "\fB\-H\fR" 4
240
.IX Item "-H"
241
.PD 0
242
.IP "\fB\-\-help\fR" 4
243
.IX Item "--help"
244
.PD
245
Displays a list of command line options and then exits.
246
.IP "\fB\-m\fR \fIcharacters\fR" 4
247
.IX Item "-m characters"
248
.PD 0
249
.IP "\fB\-\-maxlength\fR \fIcharacters\fR" 4
250
.IX Item "--maxlength characters"
251
.PD
252
Instructs \fBwindmc\fR to generate a warning if the length
253
of any message exceeds the number specified.
254
.IP "\fB\-n\fR" 4
255
.IX Item "-n"
256
.PD 0
257
.IP "\fB\-\-nullterminate\fR" 4
258
.IX Item "--nullterminate"
259
.PD
260
Terminate message text in \f(CW\*(C`bin\*(C'\fR files by zero. By default they are
261
terminated by \s-1CR/LF\s0.
262
.IP "\fB\-o\fR" 4
263
.IX Item "-o"
264
.PD 0
265
.IP "\fB\-\-hresult_use\fR" 4
266
.IX Item "--hresult_use"
267
.PD
268
Not yet implemented. Instructs \f(CW\*(C`windmc\*(C'\fR to generate an \s-1OLE2\s0 header
269
file, using \s-1HRESULT\s0 definitions. Status codes are used if the flag is not
270
specified.
271
.IP "\fB\-O\fR \fIcodepage\fR" 4
272
.IX Item "-O codepage"
273
.PD 0
274
.IP "\fB\-\-codepage_out\fR \fIcodepage\fR" 4
275
.IX Item "--codepage_out codepage"
276
.PD
277
Sets the default codepage to be used to output text files. The default
278
is ocdepage 1252.
279
.IP "\fB\-r\fR \fIpath\fR" 4
280
.IX Item "-r path"
281
.PD 0
282
.IP "\fB\-\-rcdir\fR \fIpath\fR" 4
283
.IX Item "--rcdir path"
284
.PD
285
The target directory for the generated \f(CW\*(C`rc\*(C'\fR script and the generated
286
\&\f(CW\*(C`bin\*(C'\fR files that the resource compiler script includes. The default
287
is the current directory.
288
.IP "\fB\-u\fR" 4
289
.IX Item "-u"
290
.PD 0
291
.IP "\fB\-\-unicode_in\fR" 4
292
.IX Item "--unicode_in"
293
.PD
294
Specifies that the input file is \s-1UTF16\s0.
295
.IP "\fB\-U\fR" 4
296
.IX Item "-U"
297
.PD 0
298
.IP "\fB\-\-unicode_out\fR" 4
299
.IX Item "--unicode_out"
300
.PD
301
Specifies that messages in the output \f(CW\*(C`bin\*(C'\fR file should be in \s-1UTF16\s0
302
format. This is the default behaviour.
303
.IP "\fB\-v\fR" 4
304
.IX Item "-v"
305
.PD 0
306
.IP "\fB\-\-verbose\fR" 4
307
.IX Item "--verbose"
308
.PD
309
Enable verbose mode.
310
.IP "\fB\-V\fR" 4
311
.IX Item "-V"
312
.PD 0
313
.IP "\fB\-\-version\fR" 4
314
.IX Item "--version"
315
.PD
316
Prints the version number for \fBwindmc\fR.
317
.IP "\fB\-x\fR \fIpath\fR" 4
318
.IX Item "-x path"
319
.PD 0
320
.IP "\fB\-\-xdgb\fR \fIpath\fR" 4
321
.IX Item "--xdgb path"
322
.PD
323
The path of the \f(CW\*(C`dbg\*(C'\fR C include file that maps message id's to the
324
symbolic name. No such file is generated without specifying the switch.
325
.IP "\fB@\fR\fIfile\fR" 4
326
.IX Item "@file"
327
Read command-line options from \fIfile\fR.  The options read are
328
inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
329
does not exist, or cannot be read, then the option will be treated
330
literally, and not removed.
331
.Sp
332
Options in \fIfile\fR are separated by whitespace.  A whitespace
333
character may be included in an option by surrounding the entire
334
option in either single or double quotes.  Any character (including a
335
backslash) may be included by prefixing the character to be included
336
with a backslash.  The \fIfile\fR may itself contain additional
337
@\fIfile\fR options; any such options will be processed recursively.
338
.SH "SEE ALSO"
339
.IX Header "SEE ALSO"
340
the Info entries for \fIbinutils\fR.
341
.SH "COPYRIGHT"
342
.IX Header "COPYRIGHT"
343
Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
344
2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
345
.PP
346
Permission is granted to copy, distribute and/or modify this document
347
under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.2
348
or any later version published by the Free Software Foundation;
349
with no Invariant Sections, with no Front-Cover Texts, and with no
350
Back-Cover Texts.  A copy of the license is included in the
351
section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.