Penguin
Recent Changes
Annotated edit history of windres(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 WINDRES
2 !!!WINDRES
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SEE ALSO
8 COPYRIGHT
9 ----
10 !!NAME
11
12
13 windres - manipulate Windows resources.
14 !!SYNOPSIS
15
16
17 windres [[options] [[input-file] [[output-file]
18 !!DESCRIPTION
19
20
21 __windres__ reads resources from an input file and copies
22 them into an output file. Either file may be in one of three
23 formats:
24
25
26 rc
27
28
29 A text format read by the Resource Compiler.
30
31
32 res
33
34
35 A binary format generated by the Resource
36 Compiler.
37
38
39 coff
40
41
42 A COFF object or executable.
43
44
45 The exact description of these different formats is
46 available in documentation from Microsoft.
47
48
49 When __windres__ converts from the rc format to
50 the res format, it is acting like the Windows
51 Resource Compiler. When __windres__ converts from the
52 res format to the coff format, it is
53 acting like the Windows CVTRES
54 program.
55
56
57 When __windres__ generates an rc file, the
58 output is similar but not identical to the format expected
59 for the input. When an input rc file refers to an
60 external filename, an output rc file will instead
61 include the file contents.
62
63
64 If the input or output format is not specified,
65 __windres__ will guess based on the file name, or, for
66 the input file, the file contents. A file with an extension
67 of ''.rc'' will be treated as an rc file, a file
68 with an extension of ''.res'' will be treated as a
69 res file, and a file with an extension of ''.o''
70 or ''.exe'' will be treated as a coff
71 file.
72
73
74 If no output file is specified, __windres__ will print
75 the resources in rc format to standard
76 output.
77
78
79 The normal use is for you to write an rc file, use
80 __windres__ to convert it to a COFF object
81 file, and then link the COFF file into your
82 application. This will make the resources described in the
83 rc file available to Windows.
84 !!OPTIONS
85
86
87 __-i__ ''filename''
88
89
90 __--input__ ''filename''
91
92
93 The name of the input file. If this option is not used, then
94 __windres__ will use the first non-option argument as the
95 input file name. If there are no non-option arguments, then
96 __windres__ will read from standard input. __windres__
97 can not read a COFF file from standard
98 input.
99
100
101 __-o__ ''filename''
102
103
104 __--output__ ''filename''
105
106
107 The name of the output file. If this option is not used,
108 then __windres__ will use the first non-option argument,
109 after any used for the input file name, as the output file
110 name. If there is no non-option argument, then
111 __windres__ will write to standard output. __windres__
112 can not write a COFF file to standard
113 output.
114
115
116 __-I__ ''format''
117
118
119 __--input-format__ ''format''
120
121
122 The input format to read. ''format'' may be __res__,
123 __rc__, or __coff__. If no input format is specified,
124 __windres__ will guess, as described above.
125
126
127 __-O__ ''format''
128
129
130 __--output-format__ ''format''
131
132
133 The output format to generate. ''format'' may be
134 __res__, __rc__, or __coff__. If no output format
135 is specified, __windres__ will guess, as described
136 above.
137
138
139 __-F__ ''target''
140
141
142 __--target__ ''target''
143
144
145 Specify the BFD format to use for a
146 COFF file as input or output. This is a
147 BFD target name; you can use the
148 __--help__ option to see a list of supported targets.
149 Normally __windres__ will use the default format, which
150 is the first one listed by the __--help__
151 option.
152
153
154 __--preprocessor__ ''program''
155
156
157 When __windres__ reads an rc file, it runs it
158 through the C preprocessor first. This option may be used to
159 specify the preprocessor to use, including any leading
160 arguments. The default preprocessor argument is gcc -E
161 -xc-header -DRC_INVOKED.
162
163
164 __--include-dir__ ''directory''
165
166
167 Specify an include directory to use when reading an
168 rc file. __windres__ will pass this to the
169 preprocessor as an __-I__ option. __windres__ will
170 also search this directory when looking for files named in
171 the rc file.
172
173
174 __-D__ ''target''
175
176
177 __--define__
178 ''sym''__[[=__''val''__]__
179
180
181 Specify a __-D__ option to pass to the preprocessor when
182 reading an rc file.
183
184
185 __-v__
186
187
188 Enable verbose mode. This tells you what the preprocessor is
189 if you didn't specify one.
190
191
192 __--language__ ''val''
193
194
195 Specify the default language to use when reading an
196 rc file. ''val'' should be a hexadecimal
197 language code. The low eight bits are the language, and the
198 high eight bits are the sublanguage.
199
200
201 __--use-temp-file__
202
203
204 Use a temporary file to instead of using popen to read the
205 output of the preprocessor. Use this option if the popen
206 implementation is buggy on the host (eg., certain
207 non-English language versions of Windows 95 and Windows 98
208 are known to have buggy popen where the output will instead
209 go the console).
210
211
212 __--no-use-temp-file__
213
214
215 Use popen, not a temporary file, to read the output of the
216 preprocessor. This is the default behaviour.
217
218
219 __--help__
220
221
222 Prints a usage summary.
223
224
225 __--version__
226
227
228 Prints the version number for __windres__.
229
230
231 __--yydebug__
232
233
234 If __windres__ is compiled with YYDEBUG defined
235 as 1, this will turn on parser
236 debugging.
237 !!SEE ALSO
238
239
240 the Info entries for ''binutils''.
241 !!COPYRIGHT
242
243
244 Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000,
245 2001, 2002 Free Software Foundation, Inc.
246
247
248 Permission is granted to copy, distribute and/or modify this
249 document under the terms of the GNU Free
250 Documentation License, Version 1.1 or any later version
251 published by the Free Software Foundation; with no Invariant
252 Sections, with no Front-Cover Texts, and with no Back-Cover
253 Texts. A copy of the license is included in the section
254 entitled `` GNU Free Documentation
255 License''.
256 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.