m

mkmsgs(1)

mkmsgs(1)

NAME

mkmsgs - create message ®les for use by gettxt()

SYNOPSIS

mkmsgs [-o][-ilocale] text®le msg®le

DESCRIPTION

The mkmsgs command takes as input a ®le of localized text strings and generates a message ®le that can be accessed by the gettxt(3C) routine. text®le is the name of the ®le that contains the text strings. msg®le is the name of the output message ®le. mkmsgs appends the suf®x .cat to the message ®le name. The combined length of the ®le name should be less than 14 bytes for short ®le name ®le system. The msg®le ®le should not contain a colon since it will confuse the formatting routines.

The text®le ®le contains the localized text strings. The text strings are separated by a newline character. The text strings are processed sequentially and copied to the msg®le message ®le. An empty line in the input results in a corresponding empty message written to the msg®le message ®le.

Options

The mkmsgs command supports the following options:

-o

Overwrite the msg®le message ®le if it exists.

-ilocale The msg®le message ®le is installed in the system-wide localization directory corresponding to the speci®ed locale. Only a user with the appropriate privileges can create or overwrite the message ®le 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 speci®ed in the environment or is set to the empty string, the value of LANG is used as a default for each unspeci®ed or empty variable. If LANG is not speci®ed 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.

SEE ALSO

gencat(1), gettxt(3C), setlocale(3C).

STANDARDS COMPLIANCE

mkmsgs: SVID3

Section 1−536

− 1 −

HP-UX Release 11i: December 2000