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