GENCAT(1) | General Commands Manual | GENCAT(1) |
gencat
— NLS
catalog compiler
gencat |
output-file input-files... |
The gencat
utility merges the text NLS
input files input-files... into a formatted message
catalog file output-file. The file
output-file will be created if it does not already
exist. If output-file does exist, its messages will be
included in the new output-file. If set and message
numbers collide, the new message text defined in
input-files... will replace the old message text
currently contained in output-file.
The format of a message text source file is defined below. Note that the fields of a message text source line are separated by a single space character: any other space characters are considered to be part of the field contents.
$set
n comment$set
or end-of-file appears. The argument
n is the set identifier which is defined as a number
in the range [1, (NL_SETMAX)]. Set identifiers must occur in ascending
order within a single source file, but need not be contiguous. Any string
following a space following the set identifier is treated as a comment. If
no $set
directive is specified in a given source
file, all messages will be located in the default message set
NL_SETD.$del
n comment$
comment$
followed by a space is
treated as a comment.$set
directive, and the message identifier
m. If the message-text is
empty, and there is a space character following the message identifier, an
empty string is stored in the message catalog. If the
message-text is empty, and if there is no space
character following the message identifier, then the existing message in
the current set with the specified message identifier is deleted from the
catalog. Message identifiers must be in ascending order within a single
set, but need not be contiguous. The message-text
length must be in the range [0, (NL_TEXTMAX)].$quote
c$quote
directive is
specified, no quoting of message-text will be
recognized.Empty lines in message source files are ignored. The effect of lines beginning with any character other than those described above is undefined.
Text strings can contain the following special characters and escape sequences. In addition, if a quote character is defined, it may be escaped as well to embed a literal quote character.
A backslash character immediately before the end of the line in a file is used to continue the line onto the next line, e.g.:
1 This line is continued
\
on this line.
If the character following the backslash is not one of those specified, the backslash is ignored.
The gencat
utility exits 0 on
success, and >0 if an error occurs.
The gencat
utility is compliant with the
X/Open Portability Guide Issue 4
(“XPG4”) standard.
This manual page was originally written by Ken Stailey and later revised by Terry Lambert.
A message catalog file created from a blank input file cannot be revised; it must be deleted and recreated.
June 11, 1997 | macOS 14.6 |