dumpmsg(CP)                    6 January 1993                    dumpmsg(CP)


 Name

    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 pro-
    cessed 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


 See also

    gencat(CP), mar(CP)

 Standards conformance

    This utility is specific to this implementation.