findmsg(1)

NAME

findmsg, dumpmsg − create message catalog file for modification

SYNOPSIS

findmsg [-a] file ...
dumpmsg file ...

DESCRIPTION

findmsg 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)). 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. gencat does not accept the resulting output if any two source files contain messages belonging to the same set number. The -a option causes findmsg to merge identically numbered sets from multiple input files so that gencat can process the findmsg output.

findmsg 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. 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.

dumpmsg 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- and/or multi-byte characters.

LANG determines the language in which messages are displayed.

If LC_CTYPE 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

Single- and multi-byte character code sets are supported.

WARNINGS

For historical reasons, findmsg also recognizes the formats:

nl_msg(n, "message")

"message" /* nl_msg n */

/* nl_msg n */ "message"

Use of these formats is not recommended.

AUTHOR

findmsg was developed by HP.

Museum

Related Articles