Command Reference Guide
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1/!!!intro.1
________________________________________________________________
___ ___
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 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 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. Condi-
tional 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 vari-
able contains an invalid setting, findmsg and dumpmsg behave as if all internationalization variables are
set to C. See environ(5).
International Code Set Support
Single-byte and multi-byte character code sets are supported.
HP-UX Release 11i: December 2000 − 1 − Section 1−−277
___
___