1<html lang="en"> 2<head> 3<title>windmc - GNU Binary Utilities</title> 4<meta http-equiv="Content-Type" content="text/html"> 5<meta name="description" content="GNU Binary Utilities"> 6<meta name="generator" content="makeinfo 4.13"> 7<link title="Top" rel="start" href="index.html#Top"> 8<link rel="prev" href="windres.html#windres" title="windres"> 9<link rel="next" href="dlltool.html#dlltool" title="dlltool"> 10<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 11<!-- 12Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 132000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 14Free Software Foundation, Inc. 15 16Permission is granted to copy, distribute and/or modify this document 17under the terms of the GNU Free Documentation License, Version 1.3 18or any later version published by the Free Software Foundation; 19with no Invariant Sections, with no Front-Cover Texts, and with no 20Back-Cover Texts. A copy of the license is included in the 21section entitled ``GNU Free Documentation License''. 22 23--> 24<meta http-equiv="Content-Style-Type" content="text/css"> 25<style type="text/css"><!-- 26 pre.display { font-family:inherit } 27 pre.format { font-family:inherit } 28 pre.smalldisplay { font-family:inherit; font-size:smaller } 29 pre.smallformat { font-family:inherit; font-size:smaller } 30 pre.smallexample { font-size:smaller } 31 pre.smalllisp { font-size:smaller } 32 span.sc { font-variant:small-caps } 33 span.roman { font-family:serif; font-weight:normal; } 34 span.sansserif { font-family:sans-serif; font-weight:normal; } 35--></style> 36<link rel="stylesheet" type="text/css" href="../cs.css"> 37</head> 38<body> 39<div class="node"> 40<a name="windmc"></a> 41<p> 42Next: <a rel="next" accesskey="n" href="dlltool.html#dlltool">dlltool</a>, 43Previous: <a rel="previous" accesskey="p" href="windres.html#windres">windres</a>, 44Up: <a rel="up" accesskey="u" href="index.html#Top">Top</a> 45<hr> 46</div> 47 48<h2 class="chapter">12 windmc</h2> 49 50<p><samp><span class="command">windmc</span></samp> may be used to generator Windows message resources. 51 52 <blockquote> 53<em>Warning:</em> <samp><span class="command">windmc</span></samp> is not always built as part of the binary 54utilities, since it is only useful for Windows targets. 55</blockquote> 56 57<!-- man title windmc generates Windows message resources. --> 58<pre class="smallexample"> <!-- man begin SYNOPSIS windmc --> 59 windmc [options] input-file 60 <!-- man end --> 61</pre> 62 <!-- man begin DESCRIPTION windmc --> 63 <p><samp><span class="command">windmc</span></samp> reads message definitions from an input file (.mc) and 64translate them into a set of output files. The output files may be of 65four kinds: 66 67 <dl> 68<dt><code>h</code><dd>A C header file containing the message definitions. 69 70 <br><dt><code>rc</code><dd>A resource file compilable by the <samp><span class="command">windres</span></samp> tool. 71 72 <br><dt><code>bin</code><dd>One or more binary files containing the resource data for a specific 73message language. 74 75 <br><dt><code>dbg</code><dd>A C include file that maps message id's to their symbolic name. 76</dl> 77 78 <p>The exact description of these different formats is available in 79documentation from Microsoft. 80 81 <p>When <samp><span class="command">windmc</span></samp> converts from the <code>mc</code> format to the <code>bin</code> 82format, <code>rc</code>, <code>h</code>, and optional <code>dbg</code> it is acting like the 83Windows Message Compiler. 84 85<!-- man end --> 86<!-- man begin OPTIONS windmc --> 87 <dl> 88<dt><samp><span class="env">-a</span></samp><dt><samp><span class="env">--ascii_in</span></samp><dd>Specifies that the input file specified is ASCII. This is the default 89behaviour. 90 91 <br><dt><samp><span class="env">-A</span></samp><dt><samp><span class="env">--ascii_out</span></samp><dd>Specifies that messages in the output <code>bin</code> files should be in ASCII 92format. 93 94 <br><dt><samp><span class="env">-b</span></samp><dt><samp><span class="env">--binprefix</span></samp><dd>Specifies that <code>bin</code> filenames should have to be prefixed by the 95basename of the source file. 96 97 <br><dt><samp><span class="env">-c</span></samp><dt><samp><span class="env">--customflag</span></samp><dd>Sets the customer bit in all message id's. 98 99 <br><dt><samp><span class="env">-C </span><var>codepage</var></samp><dt><samp><span class="env">--codepage_in </span><var>codepage</var></samp><dd>Sets the default codepage to be used to convert input file to UTF16. The 100default is ocdepage 1252. 101 102 <br><dt><samp><span class="env">-d</span></samp><dt><samp><span class="env">--decimal_values</span></samp><dd>Outputs the constants in the header file in decimal. Default is using 103hexadecimal output. 104 105 <br><dt><samp><span class="env">-e </span><var>ext</var></samp><dt><samp><span class="env">--extension </span><var>ext</var></samp><dd>The extension for the header file. The default is .h extension. 106 107 <br><dt><samp><span class="env">-F </span><var>target</var></samp><dt><samp><span class="env">--target </span><var>target</var></samp><dd>Specify the BFD format to use for a bin file as output. This 108is a BFD target name; you can use the <samp><span class="option">--help</span></samp> option to see a list 109of supported targets. Normally <samp><span class="command">windmc</span></samp> will use the default 110format, which is the first one listed by the <samp><span class="option">--help</span></samp> option. 111<a href="Target-Selection.html#Target-Selection">Target Selection</a>. 112 113 <br><dt><samp><span class="env">-h </span><var>path</var></samp><dt><samp><span class="env">--headerdir </span><var>path</var></samp><dd>The target directory of the generated header file. The default is the 114current directory. 115 116 <br><dt><samp><span class="env">-H</span></samp><dt><samp><span class="env">--help</span></samp><dd>Displays a list of command line options and then exits. 117 118 <br><dt><samp><span class="env">-m </span><var>characters</var></samp><dt><samp><span class="env">--maxlength </span><var>characters</var></samp><dd>Instructs <samp><span class="command">windmc</span></samp> to generate a warning if the length 119of any message exceeds the number specified. 120 121 <br><dt><samp><span class="env">-n</span></samp><dt><samp><span class="env">--nullterminate</span></samp><dd>Terminate message text in <code>bin</code> files by zero. By default they are 122terminated by CR/LF. 123 124 <br><dt><samp><span class="env">-o</span></samp><dt><samp><span class="env">--hresult_use</span></samp><dd>Not yet implemented. Instructs <code>windmc</code> to generate an OLE2 header 125file, using HRESULT definitions. Status codes are used if the flag is not 126specified. 127 128 <br><dt><samp><span class="env">-O </span><var>codepage</var></samp><dt><samp><span class="env">--codepage_out </span><var>codepage</var></samp><dd>Sets the default codepage to be used to output text files. The default 129is ocdepage 1252. 130 131 <br><dt><samp><span class="env">-r </span><var>path</var></samp><dt><samp><span class="env">--rcdir </span><var>path</var></samp><dd>The target directory for the generated <code>rc</code> script and the generated 132<code>bin</code> files that the resource compiler script includes. The default 133is the current directory. 134 135 <br><dt><samp><span class="env">-u</span></samp><dt><samp><span class="env">--unicode_in</span></samp><dd>Specifies that the input file is UTF16. 136 137 <br><dt><samp><span class="env">-U</span></samp><dt><samp><span class="env">--unicode_out</span></samp><dd>Specifies that messages in the output <code>bin</code> file should be in UTF16 138format. This is the default behaviour. 139 140 <br><dt><samp><span class="env">-v</span></samp><br><dt><samp><span class="env">--verbose</span></samp><dd>Enable verbose mode. 141 142 <br><dt><samp><span class="env">-V</span></samp><br><dt><samp><span class="env">--version</span></samp><dd>Prints the version number for <samp><span class="command">windmc</span></samp>. 143 144 <br><dt><samp><span class="env">-x </span><var>path</var></samp><dt><samp><span class="env">--xdgb </span><var>path</var></samp><dd>The path of the <code>dbg</code> C include file that maps message id's to the 145symbolic name. No such file is generated without specifying the switch. 146</dl> 147 148<!-- man end --> 149 </body></html> 150 151