findmsg(1)                                                       findmsg(1)




 NAME    [Toc]    [Back]
      findmsg, dumpmsg - create message catalog file for modification

 SYNOPSIS    [Toc]    [Back]
      findmsg [-aiv] [[-D sym] [-U sym]] file ...

      dumpmsg file ...

 DESCRIPTION    [Toc]    [Back]
      The findmsg command extracts messages from a C program source file and
      writes them to the standard output in a format suitable for input to
      gencat (see gencat(1)).  The input file will be preprocessed using cpp
      (see cpp(1)) in order to select print specifiers and handle ifdef,
      ifndef...  conditional cpp primitives.  If multiple input files are
      specified and the -a option is not used, the files are processed
      sequentially such that message catalog comment lines identifying the
      input file are written before the output for each input file.

      The findmsg command scans the source files for uncommented lines with
      one of the following three formats embedded within it:

           catgets(any_var,NL_SETN,n,<message>)

           <message>            /* catgets n */

           /* catgets n */     <message>

      or any combination of these formats wholly contained on a single
      physical line.  <message> could be a string constant or a combination
      of string constants and print specifiers (PRI*).  Any number of spaces
      or tabs can separate the catgets comment from the message.  The digit
      n, which can be any valid message number (see gencat(1)), is combined
      with the message string to produce a message catalog source line.  The
      message source line is assigned to the set whose number is the current
      value of NL_SETN as set by the last #define directive encountered.  If
      NL_SETN has not yet been defined when a message line is found, the
      message is output without a set number specification.  If more than
      one message is found belonging to the same set and message number, the
      last message found is output; any others are silently discarded.
      Conditional compilation and #include instructions in the C source
      files are ignored.

    Options    [Toc]    [Back]
      findmsg recognizes the following command-line options:

           -a          Merge identically numbered sets from multiple input
                       files so that gencat can process the findmsg output.

           -Dsym       Define symbol sym.





 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 findmsg(1)                                                       findmsg(1)




           -Usym       Cause symbol sym to be undefined.

           -i          Consider all #ifdefs to extract messages from the
                       input file.  Options -D and -U will be used to select
                       print specifiers if this option is not used.

           -v          Outputs all error messages issued by cpp.  By
                       default, findmsg does not display the error messages
                       issued by cpp.

      The dumpmsg command extracts messages from a message catalog file
      created by gencat.  Messages are written to standard output in a
      format suitable for editing and re-input to gencat.

 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      LC_CTYPE determines the interpretation of messages as single-byte
      and/or multi-byte characters.

      LC_MESSAGES determines the language in which messages are displayed.

      If LC_CTYPE or LC_MESSAGES is not specified in the environment or is
      set to the empty string, the value of LANG is used as a default for
      each unspecified or empty variable.  If LANG is not specified or is
      set to the empty string, a default of C (see lang(5)) is used instead
      of LANG.  If any internationalization variable contains an invalid
      setting, findmsg and dumpmsg behave as if all internationalization
      variables are set to C.  See environ(5).

    International Code Set Support    [Toc]    [Back]
      Single-byte and multi-byte character code sets are supported.

 WARNINGS    [Toc]    [Back]
      The findmsg and dumpmsg commands are HP proprietary, not portable to
      other vendors' systems, and will not be provided in future HP-UX
      releases.

 AUTHOR    [Toc]    [Back]
      findmsg and dumpmsg were developed by HP.

 SEE ALSO    [Toc]    [Back]
      findstr(1), gencat(1), insertmsg(1), catgets(3C).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003