.\" The Regents of the University of California. All rights reserved.
.\" This code is derived from software contributed to Berkeley by
.\" Paul Borman at Krystal Technologies.
.\" %sccs.include.redist.roff%
.\" @(#)mklocale.1 8.1 (Berkeley) %G%
.Nd make LC_CTYPE locale files
.Ar "> language/LC_CTYPE"
source file from standard input and produces a
binary file on standard output suitable for placement in
.Dv /usr/share/locale/\fIlanguage\fP/LC_CTYPE.
It consists of a series of lines which start with a keyword and have
associated data following. C style comments are used
to place comments in the file.
Besides the keywords which will be listed below,
the following are valid tokens in
may be any of the following:
.Bl -tag -width 0x[0-9a-z]*
A hexadecimal number representing a rune code.
An octal number representing a rune code.
A decimal number representing a rune code.
A string enclosed in double quotes (").
The follow characters are taken literally:
.Bl -tag -width "<\|\|(\|\|["
Used to start a mapping. All are equivalent.
Used to end a mapping. All are equivalent.
Used as a delimiter in mappings.
Key words which should only appear once are:
.Bl -tag -width PHONOGRAM
which indicates the encoding mechanism to be used for this locale.
The current encodings are:
No translation and the default.
.Dv "Universal character set Transformation Format"
.Nm "Plan 9 from Bell Labs" .
This is the preferred encoding.
encoding as used by several
This keyword must be followed by a single tab or space character,
after which encoding specific data is placed.
encoding requires variable data.
follows and is used as the invalid rune for this locale.
The following keywords may appear multiple times and have the following
.Bl -tag -width "<RUNE1 THRU RUNEn : RUNE2>"
.It Dv <RUNE1 THRU RUNEn : RUNE2>
.Bl -tag -width PHONOGRAM
Defines the tolower mappings.
is the lower case representatin of
Defines the toupper mappings.
is the upper case representatin of
Defines a map from runes to their digit value.
is the integer value represented by
For example, the ascii character
would map to the decimal value
The following keywords may appear multiple times and have the following
.Bl -tag -width "RUNE1 THRU RUNEn"
This rune has the property defined by the keyword.
.It Dv "RUNE1 THRU RUNEn"
All the runes between and including
have the property defined by the keyword.
.Bl -tag -width PHONOGRAM
Defines runes which are alphabetic, printable and graphic.
Defines runes which are control characters.
Defines runes which are decimal digits, printable and graphic.
Defines runes which are graphic and printable.
Defines runes which are lower case, printable and graphic.
Defines runes which are punctuation, printable and graphic.
Defines runes which are spaces.
Defines runes which are upper case, printable and graphic.
Defines runes which are hexadecimal digits, printable and graphic.
Defines runes which are blank.
Defines runes which are printable.
Defines runes which are ideograms, printable and graphic.
Defines runes which are special characters, printable and graphic.
Defines runes which are phonograms, printable and graphic.
utility is overly simplistic.
utility first appeared in