dumpmsg(CP)

dumpmsg -- generate a message source file

Syntax

dumpmsg [-X] [-C] [catfile | -] msgfile

Description

dumpmsg reads the formatted message catalogue catfile and generates a message source file msgfile. To read from standard input or write to standard output use ``-'' instead of catfile.

The following options are recognized:

-X: Inhibits production of only X/Open-compatible sources.
-C: Converts all non-ASCII characters of the message text to escape sequences representing the character.

Exit status

dumpmsg returns 0 if successful. The following values are returned on error:

1: fatal error occurred.
2: internal 'bug' occurred.
10: encountered warnings.
11: encountered errors (and maybe warnings).

Application usage

A text editor may be used to make leading or trailing blanks visible.

The following shell script using sed(C) dumps the messages of message catalogue chmod.cat, adds the double-quote character (") to the dumped messages, surrounds all messages with double-quotes, and copies the processed data to standard output:

   dumpmsg -X chmod.cat - | { echo \$quote \" ; \
   sed -e 's/^\([0-9][0-9]*[_\t]\)\(.*\)/\1"\2"/' ; }

In the above example, ``_'' and ``\t'' represent the space character and the tab character, respectively.

gencat and dumpmsg are capable of handling message catalogs with variable-length filenames in their file headers. To convert old message catalogs to this format, use the following example as a model:

   dumpmsg old.cat new.msg
   gencat new.cat new.msg

Standards conformance