gencat.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

gencat(1) gencat(1)

NAME

gencat - generate a formatted message catalog ﬁle

SYNOPSIS

gencat [-l] catﬁle msgﬁle ...

DESCRIPTION

Message catalogs allow a program to process input and produce output according to local customs and

languages. For details, see Native Language Support Users Guide.

The

gencat command merges each message source msgﬁle into a formatted message catalog catﬁle that

can be accessed by

catgets() (see catgets (3C)). If catﬁle does not exist, it is created. If catﬁle exists,

its messages are included in the new catﬁle . If set and message numbers collide, the new message text in

ﬁle replaces the old message text in catﬁle.Amsgﬁle consists of message, directive, and comment lines

(all without leading spaces or tabs) described below. Except as noted, ﬁelds are separated by one or more

space or tab characters.

- is speciﬁed as catalog ﬁle, standard output is used.

- is speciﬁed for an instance of message ﬁle, standard input is used.

$set s [comment]A$set

directive speciﬁes the set s, of the messages that follow until the

$set or end-of-ﬁle appears. The set number s is an unsigned integer

in the range 1 through NL_SETMAX. Any string following the set number

is treated as a comment. If a $set directive is not speciﬁed, messages are

put in the default set NL_SETD.

Set numbers must be in ascending order within a msgﬁle but need not be

contiguous.

$delset s [comment]A$delset directive deletes the message set identiﬁed by the set number

s, from an existing message catalog. Any string following the set number is

treated as a comment.

m message_text A message line speciﬁes a message number m, and associated message

text. The message number m is an unsigned integer in the range 1 through

NL_MSGMAX. The message_text is a C string, including spaces, tabs and \

(backslash) escapes, but by default without surrounding quotes (see

$quote directive below). The message number m is separated from the

message_text by a single space or tab character. The message_text begins

with the ﬁrst character following the separator and ends at new-line.

Extra spaces or tabs (including any trailing spaces or tabs) are considered

part of the message_text .

The message_text of a message line is stored in catﬁle with message

number m and set number s speciﬁed by the most recent

$set directive.

Message numbers must be in ascending order within a set, but need not be

contiguous.

Note that the space or tab separator distinguishes insertion of a null mes-

sage from deletion of a message. If a message line has a number and

separator but no text, the message number and an associated null message

string are stored in catﬁle . If a message line has a number but neither

separator nor text, the message number and its associated message text are

deleted from catﬁle .

-l If the -l option is speciﬁed, the length of message_text must be no more

than MAX_BUFLEN − 1 bytes. If the -l option is not speciﬁed, the length

of message_text must be no more than NL_TEXTMAX bytes. See

catgets (3C), for message length limits imposed by these routines.

$quote [q comment]A$quote directive speciﬁes a quote character q, used to surround

message_text and make leading and trailing space visible in a message line.

Any string following the speciﬁed quote character q is treated as a com-

ment. By default, or if a quote character q not is supplied, quoting of

message_text is not recognized.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)

PAGE 1
gencat(1) gencat(1) NAME gencat - generate a formatted message catalog file SYNOPSIS gencat [-l] catfile msgfile ... DESCRIPTION Message catalogs allow a program to process input and produce output according to local customs and languages. For details, see Native Language Support Users Guide . The gencat command merges each message source msgfile into a formatted message catalog catfile that can be accessed by catgets() (see catgets (3C)). If catfile does not exist, it is created.
PAGE 2
gencat(1) $ comment gencat(1) A $ followed by a space or tab is treated as a comment and can appear anywhere in a file. A line consisting of zero or more spaces or tabs is treated as a comment line. NL_TEXTMAX, NL_SETMAX, and NL_MSGMAX are defined in . NL_SETD is defined in . MAX_BUFLEN is defined in . EXTERNAL INFLUENCES Environment Variables LANG provides a default value for the internationalization variables that are unset or null.