NAME

findmsg, dumpmsg − create message catalogue 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(1). If multiple-input files are specified and the -a option is not used, the files are processed sequentially with message-catalogue comment lines identifying the input file written before the output for each input file.  Gencat(1) will 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 to enable gencat(1) to 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,1, "message")

"message"/∗ catgets 1 ∗/

/∗ catgets 1 ∗/"message"

or any combination of these formats wholly contained on a single physical line.  Any number of spaces or tabs may separate the catgets comment from the message.  The digit 1, which may be any valid message number (see gencat(1)), is combined with the message string to produce a message-catalogue 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; other(s) are silently discarded.  Conditional compilation and #include instructions in the C source files are ignored. 

Dumpmsg extracts messages from a message catalogue file created by gencat(1). The messages are written to standard output in a format suitable for editing and re-input to gencat(1).

WARNINGS

For historical reasons, findmsg also recognizes the formats:

nl_msg(1,"message")

"message"/∗ nl_msg 1 ∗/

/∗ nl_msg 1 ∗/"message"

The use of these formats is not recommended. 

HARDWARE DEPENDENCIES

Series 200, 300, 500
Only the nl_msg formats are currently supported. 

AUTHOR

Findmsg was developed by the Hewlett-Packard Company. 

SEE ALSO

findstr(1), gencat(1), insertmsg(1), catgets(3C). 

INTERNATIONAL SUPPORT

8- and 16-bit data, 8-bit file names. 

Hewlett-Packard Company  —  Version B.1,  May 11, 2021