prebuilt/linux-x86/toolchain/i686-unknown-linux-gnu-4.2.1/man/man1/i686-unknown-linux-gnu-windres.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.  \*(C+ will
  29 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  30 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  31 .\" nothing in troff, for use with C<>.
  32 .tr \(*W-
  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 "WINDRES 1"
 131 .TH WINDRES 1 "2006-06-23" "binutils-2.17" "GNU Development Tools"
 132 .SH "NAME"
 133 windres \- manipulate Windows resources.
 134 .SH "SYNOPSIS"
 135 .IX Header "SYNOPSIS"
 136 windres [options] [input\-file] [output\-file]
 137 .SH "DESCRIPTION"
 138 .IX Header "DESCRIPTION"
 139 \&\fBwindres\fR reads resources from an input file and copies them into
 140 an output file.  Either file may be in one of three formats:
 141 .ie n .IP """rc""" 4
 142 .el .IP "\f(CWrc\fR" 4
 143 .IX Item "rc"
 144 A text format read by the Resource Compiler.
 145 .ie n .IP """res""" 4
 146 .el .IP "\f(CWres\fR" 4
 147 .IX Item "res"
 148 A binary format generated by the Resource Compiler.
 149 .ie n .IP """coff""" 4
 150 .el .IP "\f(CWcoff\fR" 4
 151 .IX Item "coff"
 152 A \s-1COFF\s0 object or executable.
 153 .PP
 154 The exact description of these different formats is available in
 155 documentation from Microsoft.
 156 .PP
 157 When \fBwindres\fR converts from the \f(CW\*(C`rc\*(C'\fR format to the \f(CW\*(C`res\*(C'\fR
 158 format, it is acting like the Windows Resource Compiler.  When
 159 \&\fBwindres\fR converts from the \f(CW\*(C`res\*(C'\fR format to the \f(CW\*(C`coff\*(C'\fR
 160 format, it is acting like the Windows \f(CW\*(C`CVTRES\*(C'\fR program.
 161 .PP
 162 When \fBwindres\fR generates an \f(CW\*(C`rc\*(C'\fR file, the output is similar
 163 but not identical to the format expected for the input.  When an input
 164 \&\f(CW\*(C`rc\*(C'\fR file refers to an external filename, an output \f(CW\*(C`rc\*(C'\fR file
 165 will instead include the file contents.
 166 .PP
 167 If the input or output format is not specified, \fBwindres\fR will
 168 guess based on the file name, or, for the input file, the file contents.
 169 A file with an extension of \fI.rc\fR will be treated as an \f(CW\*(C`rc\*(C'\fR
 170 file, a file with an extension of \fI.res\fR will be treated as a
 171 \&\f(CW\*(C`res\*(C'\fR file, and a file with an extension of \fI.o\fR or
 172 \&\fI.exe\fR will be treated as a \f(CW\*(C`coff\*(C'\fR file.
 173 .PP
 174 If no output file is specified, \fBwindres\fR will print the resources
 175 in \f(CW\*(C`rc\*(C'\fR format to standard output.
 176 .PP
 177 The normal use is for you to write an \f(CW\*(C`rc\*(C'\fR file, use \fBwindres\fR
 178 to convert it to a \s-1COFF\s0 object file, and then link the \s-1COFF\s0 file into
 179 your application.  This will make the resources described in the
 180 \&\f(CW\*(C`rc\*(C'\fR file available to Windows.
 181 .SH "OPTIONS"
 182 .IX Header "OPTIONS"
 183 .IP "\fB\-i\fR \fIfilename\fR" 4
 184 .IX Item "-i filename"
 185 .PD 0
 186 .IP "\fB\-\-input\fR \fIfilename\fR" 4
 187 .IX Item "--input filename"
 188 .PD
 189 The name of the input file.  If this option is not used, then
 190 \&\fBwindres\fR will use the first non-option argument as the input file
 191 name.  If there are no non-option arguments, then \fBwindres\fR will
 192 read from standard input.  \fBwindres\fR can not read a \s-1COFF\s0 file from
 193 standard input.
 194 .IP "\fB\-o\fR \fIfilename\fR" 4
 195 .IX Item "-o filename"
 196 .PD 0
 197 .IP "\fB\-\-output\fR \fIfilename\fR" 4
 198 .IX Item "--output filename"
 199 .PD
 200 The name of the output file.  If this option is not used, then
 201 \&\fBwindres\fR will use the first non-option argument, after any used
 202 for the input file name, as the output file name.  If there is no
 203 non-option argument, then \fBwindres\fR will write to standard output.
 204 \&\fBwindres\fR can not write a \s-1COFF\s0 file to standard output.  Note,
 205 for compatability with \fBrc\fR the option \fB\-fo\fR is also
 206 accepted, but its use is not recommended.
 207 .IP "\fB\-J\fR \fIformat\fR" 4
 208 .IX Item "-J format"
 209 .PD 0
 210 .IP "\fB\-\-input\-format\fR \fIformat\fR" 4
 211 .IX Item "--input-format format"
 212 .PD
 213 The input format to read.  \fIformat\fR may be \fBres\fR, \fBrc\fR, or
 214 \&\fBcoff\fR.  If no input format is specified, \fBwindres\fR will
 215 guess, as described above.
 216 .IP "\fB\-O\fR \fIformat\fR" 4
 217 .IX Item "-O format"
 218 .PD 0
 219 .IP "\fB\-\-output\-format\fR \fIformat\fR" 4
 220 .IX Item "--output-format format"
 221 .PD
 222 The output format to generate.  \fIformat\fR may be \fBres\fR,
 223 \&\fBrc\fR, or \fBcoff\fR.  If no output format is specified,
 224 \&\fBwindres\fR will guess, as described above.
 225 .IP "\fB\-F\fR \fItarget\fR" 4
 226 .IX Item "-F target"
 227 .PD 0
 228 .IP "\fB\-\-target\fR \fItarget\fR" 4
 229 .IX Item "--target target"
 230 .PD
 231 Specify the \s-1BFD\s0 format to use for a \s-1COFF\s0 file as input or output.  This
 232 is a \s-1BFD\s0 target name; you can use the \fB\-\-help\fR option to see a list
 233 of supported targets.  Normally \fBwindres\fR will use the default
 234 format, which is the first one listed by the \fB\-\-help\fR option.
 235 .IP "\fB\-\-preprocessor\fR \fIprogram\fR" 4
 236 .IX Item "--preprocessor program"
 237 When \fBwindres\fR reads an \f(CW\*(C`rc\*(C'\fR file, it runs it through the C
 238 preprocessor first.  This option may be used to specify the preprocessor
 239 to use, including any leading arguments.  The default preprocessor
 240 argument is \f(CW\*(C`gcc \-E \-xc\-header \-DRC_INVOKED\*(C'\fR.
 241 .IP "\fB\-I\fR \fIdirectory\fR" 4
 242 .IX Item "-I directory"
 243 .PD 0
 244 .IP "\fB\-\-include\-dir\fR \fIdirectory\fR" 4
 245 .IX Item "--include-dir directory"
 246 .PD
 247 Specify an include directory to use when reading an \f(CW\*(C`rc\*(C'\fR file.
 248 \&\fBwindres\fR will pass this to the preprocessor as an \fB\-I\fR
 249 option.  \fBwindres\fR will also search this directory when looking for
 250 files named in the \f(CW\*(C`rc\*(C'\fR file.  If the argument passed to this command
 251 matches any of the supported \fIformats\fR (as descrived in the \fB\-J\fR
 252 option), it will issue a deprecation warning, and behave just like the
 253 \&\fB\-J\fR option.  New programs should not use this behaviour.  If a
 254 directory happens to match a \fIformat\fR, simple prefix it with \fB./\fR
 255 to disable the backward compatibility.
 256 .IP "\fB\-D\fR \fItarget\fR" 4
 257 .IX Item "-D target"
 258 .PD 0
 259 .IP "\fB\-\-define\fR \fIsym\fR\fB[=\fR\fIval\fR\fB]\fR" 4
 260 .IX Item "--define sym[=val]"
 261 .PD
 262 Specify a \fB\-D\fR option to pass to the preprocessor when reading an
 263 \&\f(CW\*(C`rc\*(C'\fR file.
 264 .IP "\fB\-U\fR \fItarget\fR" 4
 265 .IX Item "-U target"
 266 .PD 0
 267 .IP "\fB\-\-undefine\fR \fIsym\fR" 4
 268 .IX Item "--undefine sym"
 269 .PD
 270 Specify a \fB\-U\fR option to pass to the preprocessor when reading an
 271 \&\f(CW\*(C`rc\*(C'\fR file.
 272 .IP "\fB\-r\fR" 4
 273 .IX Item "-r"
 274 Ignored for compatibility with rc.
 275 .IP "\fB\-v\fR" 4
 276 .IX Item "-v"
 277 Enable verbose mode.  This tells you what the preprocessor is if you
 278 didn't specify one.
 279 .IP "\fB\-l\fR \fIval\fR" 4
 280 .IX Item "-l val"
 281 .PD 0
 282 .IP "\fB\-\-language\fR \fIval\fR" 4
 283 .IX Item "--language val"
 284 .PD
 285 Specify the default language to use when reading an \f(CW\*(C`rc\*(C'\fR file.
 286 \&\fIval\fR should be a hexadecimal language code.  The low eight bits are
 287 the language, and the high eight bits are the sublanguage.
 288 .IP "\fB\-\-use\-temp\-file\fR" 4
 289 .IX Item "--use-temp-file"
 290 Use a temporary file to instead of using popen to read the output of
 291 the preprocessor. Use this option if the popen implementation is buggy
 292 on the host (eg., certain non-English language versions of Windows 95 and
 293 Windows 98 are known to have buggy popen where the output will instead
 294 go the console).
 295 .IP "\fB\-\-no\-use\-temp\-file\fR" 4
 296 .IX Item "--no-use-temp-file"
 297 Use popen, not a temporary file, to read the output of the preprocessor.
 298 This is the default behaviour.
 299 .IP "\fB\-h\fR" 4
 300 .IX Item "-h"
 301 .PD 0
 302 .IP "\fB\-\-help\fR" 4
 303 .IX Item "--help"
 304 .PD
 305 Prints a usage summary.
 306 .IP "\fB\-V\fR" 4
 307 .IX Item "-V"
 308 .PD 0
 309 .IP "\fB\-\-version\fR" 4
 310 .IX Item "--version"
 311 .PD
 312 Prints the version number for \fBwindres\fR.
 313 .IP "\fB\-\-yydebug\fR" 4
 314 .IX Item "--yydebug"
 315 If \fBwindres\fR is compiled with \f(CW\*(C`YYDEBUG\*(C'\fR defined as \f(CW1\fR,
 316 this will turn on parser debugging.
 317 .IP "\fB@\fR\fIfile\fR" 4
 318 .IX Item "@file"
 319 Read command-line options from \fIfile\fR.  The options read are
 320 inserted in place of the original @\fIfile\fR option.  If \fIfile\fR
 321 does not exist, or cannot be read, then the option will be treated
 322 literally, and not removed.
 323 .Sp
 324 Options in \fIfile\fR are separated by whitespace.  A whitespace
 325 character may be included in an option by surrounding the entire
 326 option in either single or double quotes.  Any character (including a
 327 backslash) may be included by prefixing the character to be included
 328 with a backslash.  The \fIfile\fR may itself contain additional
 329 @\fIfile\fR options; any such options will be processed recursively.
 330 .SH "SEE ALSO"
 331 .IX Header "SEE ALSO"
 332 the Info entries for \fIbinutils\fR.
 333 .SH "COPYRIGHT"
 334 .IX Header "COPYRIGHT"
 335 Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
 336 2000, 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
 337 .PP
 338 Permission is granted to copy, distribute and/or modify this document
 339 under the terms of the \s-1GNU\s0 Free Documentation License, Version 1.1
 340 or any later version published by the Free Software Foundation;
 341 with no Invariant Sections, with no Front-Cover Texts, and with no
 342 Back-Cover Texts.  A copy of the license is included in the
 343 section entitled \*(L"\s-1GNU\s0 Free Documentation License\*(R".