Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
GENCAT(1)		FreeBSD	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 re-
     place 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
	  This line specifies the set identifier of the	following messages un-
	  til the next $set or end-of-file appears.  The argument n is the set
	  identifier which is defined as a number in the range [1, (NL_SET-
	  MAX)].  Set identifiers must occur in	ascending order	within a sin-
	  gle 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
	  This line deletes messages from set n	from a message catalog.	 The n
	  specifies a set number.  Any string following	a space	following the
	  set number is	treated	as a comment.

     $ comment
	  A line beginning with	$ followed by a	space is treated as a comment.

     m message-text
	  A message line consists of a message identifier m in the range [1,
	  (NL_MSGMAX)].	 The message-text is stored in the message catalog
	  with the set identifier specified by the last	$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,

     $quote c
	  This line specifies an optional quote	character c which can be used
	  to surround message-text so that trailing space or empty messages
	  are visible in message source	files.	By default, or if an empty
	  $quote directive is specified, no quoting of message-text will be

     Empty lines in message source files are ignored.  The effect of lines be-
     ginning with any character	other than those described above is undefined.

     Text strings can contain the following special characters and escape se-
     quences.  In addition, if a quote character is defined, it	may be escaped
     as	well to	embed a	literal	quote character.

	   \n	 line feed
	   \t	 horizontal tab
	   \v	 vertical tab
	   \b	 backspace
	   \r	 carriage return
	   \f	 form feed
	   \\	 backslash
	   \ooo	 octal number in the range [000, 377]

     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.

     catclose(3), catgets(3), catopen(3)

     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.

FreeBSD	13.0			 June 11, 1997			  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help