NAME
mkmsgs — create message files for use by gettxt()
SYNOPSIS
mkmsgs
[-o]
[-i
locale]
textfile msgfile
DESCRIPTION
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
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
Environment Variables
LC_CTYPE
determines the interpretation of messages as
single- and/or multibyte characters.
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
environ(5).
International Code Set Support
Single- and multibyte character code sets are supported.
EXAMPLES
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
mkmsgs
is provided for SVID3 compatibility only.
The user is encouraged
to use the NLS mechanism developed by
HP and the X/Open Company, Ltd.
STANDARDS COMPLIANCE
mkmsgs: SVID3