huschi.net

File: binutils.info,  Node: windmc,  Next: windres,  Prev: nlmconv,  Up: Top
12 windmc
*********
'windmc' may be used to generator Windows message resources.
     _Warning:_ 'windmc' is not always built as part of the binary
     utilities, since it is only useful for Windows targets.
     windmc [options] input-file
   '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:
'h'
     A C header file containing the message definitions.
'rc'
     A resource file compilable by the 'windres' tool.
'bin'
     One or more binary files containing the resource data for a
     specific message language.
'dbg'
     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 'mc' format to the 'bin' format,
'rc', 'h', and optional 'dbg' it is acting like the Windows Message
Compiler.
'-a'
'--ascii_in'
     Specifies that the input file specified is ASCII. This is the
     default behaviour.
'-A'
'--ascii_out'
     Specifies that messages in the output 'bin' files should be in
     ASCII format.
'-b'
'--binprefix'
     Specifies that 'bin' filenames should have to be prefixed by the
     basename of the source file.
'-c'
'--customflag'
     Sets the customer bit in all message id's.
'-C CODEPAGE'
'--codepage_in CODEPAGE'
     Sets the default codepage to be used to convert input file to
     UTF16.  The default is ocdepage 1252.
'-d'
'--decimal_values'
     Outputs the constants in the header file in decimal.  Default is
     using hexadecimal output.
'-e EXT'
'--extension EXT'
     The extension for the header file.  The default is .h extension.
'-F TARGET'
'--target TARGET'
     Specify the BFD format to use for a bin file as output.  This is a
     BFD 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.  *note Target
     Selection::.
'-h PATH'
'--headerdir PATH'
     The target directory of the generated header file.  The default is
     the current directory.
'-H'
'--help'
     Displays a list of command line options and then exits.
'-m CHARACTERS'
'--maxlength CHARACTERS'
     Instructs 'windmc' to generate a warning if the length of any
     message exceeds the number specified.
'-n'
'--nullterminate'
     Terminate message text in 'bin' files by zero.  By default they are
     terminated by CR/LF.
'-o'
'--hresult_use'
     Not yet implemented.  Instructs 'windmc' to generate an OLE2 header
     file, using HRESULT definitions.  Status codes are used if the flag
     is not specified.
'-O CODEPAGE'
'--codepage_out CODEPAGE'
     Sets the default codepage to be used to output text files.  The
     default is ocdepage 1252.
'-r PATH'
'--rcdir PATH'
     The target directory for the generated 'rc' script and the
     generated 'bin' files that the resource compiler script includes.
     The default is the current directory.
'-u'
'--unicode_in'
     Specifies that the input file is UTF16.
'-U'
'--unicode_out'
     Specifies that messages in the output 'bin' file should be in UTF16
     format.  This is the default behaviour.
'-v'
'--verbose'
     Enable verbose mode.
'-V'
'--version'
     Prints the version number for 'windmc'.
'-x PATH'
'--xdgb PATH'
     The path of the 'dbg' C include file that maps message id's to the
     symbolic name.  No such file is generated without specifying the
     switch.