[src/netbsd-1-4]: src/usr.bin/gencat Pull up revisions 1.1-1.2 (new file, req...

[he <he%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f4293318a323
branches:  netbsd-1-4
changeset: 470626:f4293318a323
user:      he <he%NetBSD.org@localhost>
date:      Thu Jun 01 17:26:07 2000 +0000

description:
Pull up revisions 1.1-1.2 (new file, requested by fair):
  Add manual page for gencat.

diffstat:

 usr.bin/gencat/gencat.1 |  101 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 101 insertions(+), 0 deletions(-)

diffs (105 lines):

diff -r 1a64a1c4a465 -r f4293318a323 usr.bin/gencat/gencat.1
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/usr.bin/gencat/gencat.1   Thu Jun 01 17:26:07 2000 +0000
@@ -0,0 +1,101 @@
+.\"
+.\" Written by Kee Hinckley <nazgul%somewhere.com@localhost>
+.\"
+.Dd April 29, 1999
+.Os
+.Dt GENCAT 1 "NLS"
+.Sh NAME
+.Nm gencat
+.Nd generates an NLS message catalog file
+.Sh SYNOPSIS
+.Nm
+.Op Fl \&?
+.Ar catalog-file
+.Ar message-file
+.Op Ar message-file ...
+.Sh DESCRIPTION
+The
+.Nm
+command reads one or more files containing message strings that will
+be displayed using the
+.Xr catgets 3
+library call.
+From these files it generates a message catalog which
+is loaded dynamically by the NLS library at run time.
+The message description files are text files in the format described below.
+The message catalog file is a binary file.
+If it already exists, it will be truncated when
+.Nm
+is run.
+.Pp
+Error messages are grouped into sets, and a program can load a
+particular set depending on which type, or language, of messages
+is desired.
+.Pp
+The
+.Fl \&?
+option flag prints the usage message.
+.Sh MESSAGE FILE FORMAT
+Empty lines and leading blanks are ignored.
+.Bl -tag -width "NN message"
+.It Em "$set NN"
+Determines the set to be used for all subsequent messages.
+.Ar "NN"
+is an integer greater than 0.
+.It Em "$delset NN"
+Removes a set from the catalog.
+.Ar "NN"
+is an integer greater than 0.
+.Pp
+If a set was created earlier in the
+current file, or in a file previously read by the
+.Nm
+command, this command will remove it.
+.It Em "$quote C"
+Sets a quote character to be used around the messages.
+.Ar "C"
+may be any character other than white space.
+.Pp
+If this is specified, then messages must begin and end with the
+quote character.
+By default no quote character is used.
+If none is specified, then the current quote character is unset. 
+This is useful when messages must contain leading white space.
+.It Em "NN message"
+Defines a message.
+.Ar "NN"
+is an integer greater than 0.
+.Pp
+The message is read until the end of the line or a quote character (if one is
+specified).
+If no message is provided, the message with the number
+.Ar "NN"
+is removed from the catalog.
+If no "set" has been created, this command generates an error.
+.El
+.Pp
+Messages may contain any characters, however the "\\"
+is special as an escape character, where the following instances
+are allowed:
+.Pp
+.Bd -literal -offset indent
+\&\\\\ Generates a single backslash.
+\&\\n  Generates a newline (as defined by the C compiler).
+\&\\t  Generates a tab (as defined by the C compiler).
+\&\\v  Generates a vertical tab (as defined by the C compiler).
+\&\\b  Generates a backspace (as defined by the C compiler).
+\&\\r  Generates a carriage return (as defined by the C compiler).
+\&\\f  Generates a form feed (as defined by the C compiler).
+\&\\NNN        Generates the character corresponding to the specified
+       octal number.
+\&\\EOL        A backslash at the end of line continues the message onto
+       the next line.
+\&\\quote      A backslash preceding the current quote character generates
+       the quote character.
+.Ed
+.Sh SEE ALSO
+.Xr catgets 3
+.Sh AUTHOR
+.Pp
+Kee Hinckley
+.Aq nazgul%somewhere.com@localhost