prebuilt/linux-x86/toolchain/arm-eabi-4.3.1/man/man1/arm-eabi-windmc.1

   1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
   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-09-10" "binutils-2.18.90" "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".