binutils: windmc
1
1 12 windmc
1 *********
1
1 'windmc' may be used to generator Windows message resources.
1
1 _Warning:_ 'windmc' is not always built as part of the binary
1 utilities, since it is only useful for Windows targets.
1
1 windmc [options] input-file
1
1 'windmc' reads message definitions from an input file (.mc) and
1 translate them into a set of output files. The output files may be of
1 four kinds:
1
1 'h'
1 A C header file containing the message definitions.
1
1 'rc'
1 A resource file compilable by the 'windres' tool.
1
1 'bin'
1 One or more binary files containing the resource data for a
1 specific message language.
1
1 'dbg'
1 A C include file that maps message id's to their symbolic name.
1
1 The exact description of these different formats is available in
1 documentation from Microsoft.
1
1 When 'windmc' converts from the 'mc' format to the 'bin' format,
1 'rc', 'h', and optional 'dbg' it is acting like the Windows Message
1 Compiler.
1
1 '-a'
1 '--ascii_in'
1 Specifies that the input file specified is ASCII. This is the
1 default behaviour.
1
1 '-A'
1 '--ascii_out'
1 Specifies that messages in the output 'bin' files should be in
1 ASCII format.
1
1 '-b'
1 '--binprefix'
1 Specifies that 'bin' filenames should have to be prefixed by the
1 basename of the source file.
1
1 '-c'
1 '--customflag'
1 Sets the customer bit in all message id's.
1
1 '-C CODEPAGE'
1 '--codepage_in CODEPAGE'
1 Sets the default codepage to be used to convert input file to
1 UTF16. The default is ocdepage 1252.
1
1 '-d'
1 '--decimal_values'
1 Outputs the constants in the header file in decimal. Default is
1 using hexadecimal output.
1
1 '-e EXT'
1 '--extension EXT'
1 The extension for the header file. The default is .h extension.
1
1 '-F TARGET'
1 '--target TARGET'
1 Specify the BFD format to use for a bin file as output. This is a
1 BFD target name; you can use the '--help' option to see a list of
1 supported targets. Normally 'windmc' will use the default format,
11 which is the first one listed by the '--help' option. ⇒Target
Selection.
1
1 '-h PATH'
1 '--headerdir PATH'
1 The target directory of the generated header file. The default is
1 the current directory.
1
1 '-H'
1 '--help'
1 Displays a list of command line options and then exits.
1
1 '-m CHARACTERS'
1 '--maxlength CHARACTERS'
1 Instructs 'windmc' to generate a warning if the length of any
1 message exceeds the number specified.
1
1 '-n'
1 '--nullterminate'
1 Terminate message text in 'bin' files by zero. By default they are
1 terminated by CR/LF.
1
1 '-o'
1 '--hresult_use'
1 Not yet implemented. Instructs 'windmc' to generate an OLE2 header
1 file, using HRESULT definitions. Status codes are used if the flag
1 is not specified.
1
1 '-O CODEPAGE'
1 '--codepage_out CODEPAGE'
1 Sets the default codepage to be used to output text files. The
1 default is ocdepage 1252.
1
1 '-r PATH'
1 '--rcdir PATH'
1 The target directory for the generated 'rc' script and the
1 generated 'bin' files that the resource compiler script includes.
1 The default is the current directory.
1
1 '-u'
1 '--unicode_in'
1 Specifies that the input file is UTF16.
1
1 '-U'
1 '--unicode_out'
1 Specifies that messages in the output 'bin' file should be in UTF16
1 format. This is the default behaviour.
1
1 '-v'
1 '--verbose'
1 Enable verbose mode.
1
1 '-V'
1 '--version'
1 Prints the version number for 'windmc'.
1
1 '-x PATH'
1 '--xdgb PATH'
1 The path of the 'dbg' C include file that maps message id's to the
1 symbolic name. No such file is generated without specifying the
1 switch.
1