'br}

'br}

{\

NAME

windmc - generates Windows message resources.

SYNOPSIS

windmc [options] input-file

DESCRIPTION

windmc reads message definitions from an input file (.mc) and translate them into a set of output files. The output files may be of four kinds:

A C header file containing the message definitions.

A resource file compilable by the windres tool.

One or more binary files containing the resource data for a specific message language.

A C include file that maps message id's to their symbolic name.

The exact description of these different formats is available in documentation from Microsoft.

When windmc converts from the f(CW*(C`mc*(C' format to the f(CW*(C`bin*(C' format, f(CW*(C`rc*(C', f(CW*(C`h*(C', and optional f(CW*(C`dbg*(C' it is acting like the Windows Message Compiler.

OPTIONS

\fB-a\fR 4

\fB--ascii_in\fR 4

Specifies that the input file specified is s-1ASCII.s0 This is the default behaviour.

\fB-A\fR 4

\fB--ascii_out\fR 4

Specifies that messages in the output f(CW*(C`bin*(C' files should be in s-1ASCIIs0 format.

\fB-b\fR 4

\fB--binprefix\fR 4

Specifies that f(CW*(C`bin*(C' filenames should have to be prefixed by the basename of the source file.

\fB-c\fR 4

\fB--customflag\fR 4

Sets the customer bit in all message id's.

\fB-C\fR \fIcodepage\fR 4

\fB--codepage_in\fR \fIcodepage\fR 4

Sets the default codepage to be used to convert input file to s-1UTF16.s0 The default is ocdepage 1252.

\fB-d\fR 4

\fB--decimal_values\fR 4

Outputs the constants in the header file in decimal. Default is using hexadecimal output.

\fB-e\fR \fIext\fR 4

\fB--extension\fR \fIext\fR 4

The extension for the header file. The default is .h extension.

\fB-F\fR \fItarget\fR 4

\fB--target\fR \fItarget\fR 4

Specify the s-1BFDs0 format to use for a bin file as output. This is a s-1BFDs0 target name; you can use the --help option to see a list of supported targets. Normally windmc will use the default format, which is the first one listed by the --help option.

\fB-h\fR \fIpath\fR 4

\fB--headerdir\fR \fIpath\fR 4

The target directory of the generated header file. The default is the current directory.

\fB-H\fR 4

\fB--help\fR 4

Displays a list of command line options and then exits.

\fB-m\fR \fIcharacters\fR 4

\fB--maxlength\fR \fIcharacters\fR 4

Instructs windmc to generate a warning if the length of any message exceeds the number specified.

\fB-n\fR 4

\fB--nullterminate\fR 4

Terminate message text in f(CW*(C`bin*(C' files by zero. By default they are terminated by s-1CR/LF.s0

\fB-o\fR 4

\fB--hresult_use\fR 4

Not yet implemented. Instructs f(CW*(C`windmc*(C' to generate an s-1OLE2s0 header file, using s-1HRESULTs0 definitions. Status codes are used if the flag is not specified.

\fB-O\fR \fIcodepage\fR 4

\fB--codepage_out\fR \fIcodepage\fR 4

Sets the default codepage to be used to output text files. The default is ocdepage 1252.

\fB-r\fR \fIpath\fR 4

\fB--rcdir\fR \fIpath\fR 4

The target directory for the generated f(CW*(C`rc*(C' script and the generated f(CW*(C`bin*(C' files that the resource compiler script includes. The default is the current directory.

\fB-u\fR 4

\fB--unicode_in\fR 4

Specifies that the input file is s-1UTF16.s0

\fB-U\fR 4

\fB--unicode_out\fR 4

Specifies that messages in the output f(CW*(C`bin*(C' file should be in s-1UTF16s0 format. This is the default behaviour.

\fB-v\fR 4

\fB--verbose\fR 4

Enable verbose mode.

\fB-V\fR 4

\fB--version\fR 4

Prints the version number for windmc.

\fB-x\fR \fIpath\fR 4

\fB--xdgb\fR \fIpath\fR 4

The path of the f(CW*(C`dbg*(C' C include file that maps message id's to the symbolic name. No such file is generated without specifying the switch.

\fB@\fR\fIfile\fR 4

Read command-line options from file. The options read are inserted in place of the original @file option. If file does not exist, or cannot be read, then the option will be treated literally, and not removed.

Options in file are separated by whitespace. A whitespace character may be included in an option by surrounding the entire option in either single or double quotes. Any character (including a backslash) may be included by prefixing the character to be included with a backslash. The file may itself contain additional @file options; any such options will be processed recursively.

SEE ALSO

the Info entries for binutils.

COPYRIGHT

Copyright (c) 1991-2014 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the s-1GNUs0 Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the section entitled *(L"s-1GNUs0 Free Documentation License*(R".