Mac OS X / Darwin man pages : mklocale (1)
mklocale (1)
Table of Contents
mklocale - make LC_CTYPE locale files
mklocale [-d] < src-file > language/LC_CTYPE
mklocale [-d] -o language/LC_CTYPE src-file
The mklocale utility reads a LC_CTYPE source file from standard input and
produces a LC_CTYPE binary file on standard output suitable for placement
in /usr/share/locale/language/LC_CTYPE.
The format of src-file is quite simple. 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.
Following options are available:
- -d
- Turns on debugging messages.
- -o
- Specify output file.
Besides the keywords which will be listed below, the following are valid
tokens in src-file:
- RUNE
- A RUNE may be any of the following:
- `x'
- The ASCII character x.
- `\x'
- The ANSI C character \x where \x is one of \a, \b,
\f, \n, \r, \t, or \v.
0x[0-9a-z]* A hexadecimal number representing a rune code.
- 0[0-7]*
- An octal number representing a rune code.
[1-9][0-9]* A decimal number representing a rune code.
- STRING
- A string enclosed in double quotes (").
- THRU
- Either ... or -. Used to indicate ranges.
literal The follow characters are taken literally:
<([ 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:
- ENCODING
- Followed by a STRING which indicates the encoding mechanism to
be used for this locale. The current encodings are:
- BIG5
- The ``Big5'' encoding of Chinese.
- EUC
- EUC encoding as used by several vendors of UNIX systems.
MSKanji The method of encoding Japanese used by Microsoft,
loosely based on JIS. Also known as ``Shift JIS''
and ``SJIS''.
- NONE
- No translation and the default.
- UTF2
- (deprecated) ``Universal character set Transformation
Format'' adopted from Plan 9 from Bell Labs.
- UTF-8
- The UTF-8 transformation format of ISO 10646 as
defined by RFC 2279.
- VARIABLE
- This keyword must be followed by a single tab or space character,
after which encoding specific data is placed. Currently
only the EUC encoding requires variable data. See euc(4)
for
further details.
- INVALID
- (deprecated) A single RUNE follows and is used as the invalid
rune for this locale.
The following keywords may appear multiple times and have the following
format for data:
- <RUNE1 RUNE2>
- RUNE1 is mapped to RUNE2.
<RUNE1 THRU RUNEn: RUNE2> Runes RUNE1 through RUNEn are mapped to
RUNE2 through RUNE2 + n-1.
MAPLOWER Defines the tolower mappings. RUNE2 is the lower case representation
of RUNE1.
MAPUPPER Defines the toupper mappings. RUNE2 is the upper case representation
of RUNE1.
- TODIGIT
- Defines a map from runes to their digit value. RUNE2 is the
integer value represented by RUNE1. For example, the ASCII
character `0' would map to the decimal value 0. Only values
up to 255 are allowed.
The following keywords may appear multiple times and have the following
format for data:
- RUNE
- This rune has the property defined by the keyword.
RUNE1 THRU RUNEn All the runes between and including RUNE1 and
RUNEn have the property defined by the keyword.
- ALPHA
- Defines runes which are alphabetic, printable and graphic.
- CONTROL
- Defines runes which are control characters.
- DIGIT
- Defines runes which are decimal digits, printable and graphic.
- GRAPH
- Defines runes which are graphic and printable.
- LOWER
- Defines runes which are lower case, printable and graphic.
- PUNCT
- Defines runes which are punctuation, printable and graphic.
- SPACE
- Defines runes which are spaces.
- UPPER
- Defines runes which are upper case, printable and graphic.
- XDIGIT
- Defines runes which are hexadecimal digits, printable and
graphic.
- BLANK
- Defines runes which are blank.
- PRINT
- Defines runes which are printable.
- IDEOGRAM
- Defines runes which are ideograms, printable and graphic.
- SPECIAL
- Defines runes which are special characters, printable and
graphic.
PHONOGRAM Defines runes which are phonograms, printable and graphic.
- SWIDTH0
- Defines runes with display width 0.
- SWIDTH1
- Defines runes with display width 1.
- SWIDTH2
- Defines runes with display width 2.
- SWIDTH3
- Defines runes with display width 3.
If no display width explicitly defined, width 1 assumed for printable
runes by default.
colldef(1)
, mbrune(3)
, rune(3)
, setlocale(3)
, wcwidth(3)
, euc(4)
,
utf2(4)
, utf8(5)
The mklocale utility is overly simplistic.
The mklocale utility first appeared in 4.4BSD.
Table of Contents
|
