NAME [Toc] [Back]
mkmsgs - create message files for use by gettxt()
SYNOPSIS [Toc] [Back]
mkmsgs [-o] [-i locale] textfile msgfile
DESCRIPTION [Toc] [Back]
The mkmsgs command takes as input a file of localized text strings and
generates a message file that can be accessed by the gettxt(3C)
routine. textfile is the name of the file that contains the text
strings. msgfile is the name of the output message file. mkmsgs
appends the suffix .cat to the message file name. The combined length
of the file name should be less than 14 bytes for short file name file
system. The msgfile file should not contain a colon since it will
confuse the formatting routines.
The textfile file contains the localized text strings. The text
strings are separated by a newline character. The text strings are
processed sequentially and copied to the msgfile message file. An
empty line in the input results in a corresponding empty message
written to the msgfile message file.
Options [Toc] [Back]
The mkmsgs command supports the following options:
-o Overwrite the msgfile message file if it exists.
-i locale The msgfile message file is installed in the
system-wide localization directory corresponding
to the specified locale. Only a user with the
appropriate privileges can create or overwrite the
message file in that directory. The directory
will be created if it does not exist.
EXTERNAL INFLUENCES [Toc] [Back]
LC_CTYPE determines the interpretation of messages as single- and/or
Messages are issued in LANG if it is set to a valid language and LANG
messages are available. Otherwise "C" locale messages are issued.
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, mkmsgs
behaves as if all internationalization variables are set to "C". See
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
International Code Set Support [Toc] [Back]
Single- and multibyte character code sets are supported.
EXAMPLES [Toc] [Back]
The following example shows the format of the input text strings:
global %s not found\n
\n\n<press return to continue>\n\n
\t%s, %d, %d,typ = %d, disp = '%s'\n
WARNINGS [Toc] [Back]
mkmsgs is provided for SVID3 compatibility only. The user is
encouraged to use the NLS mechanism developed by HP and the X/Open
SEE ALSO [Toc] [Back]
gencat(1), gettxt(3C), setlocale(3C).
STANDARDS COMPLIANCE [Toc] [Back]
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]