findmsg.1 (2010 09)

f
findmsg(1) findmsg(1)
NAME
findmsg, dumpmsg - create message catalog file for modification
SYNOPSIS
findmsg [-aiv][[-D sym ][
-U sym ]] file ...
dumpmsg file ...
DESCRIPTION
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 primi-
tives. If multiple input files are specified and the
-a option is not used, the files are processed sequen-
tially 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 for-
mats 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
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.
-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
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 vari-
ables are set to C. See environ (5).
International Code Set Support
Single-byte and multi-byte character code sets are supported.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1