1 .\" Copyright (c) 1993, 1994
2 .\" The Regents of the University of California. All rights reserved.
4 .\" This code is derived from software contributed to Berkeley by
5 .\" Paul Borman at Krystal Technologies.
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\" notice, this list of conditions and the following disclaimer in the
14 .\" documentation and/or other materials provided with the distribution.
15 .\" 3. All advertising materials mentioning features or use of this software
16 .\" must display the following acknowledgement:
17 .\" This product includes software developed by the University of
18 .\" California, Berkeley and its contributors.
19 .\" 4. Neither the name of the University nor the names of its contributors
20 .\" may be used to endorse or promote products derived from this software
21 .\" without specific prior written permission.
23 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 .\" @(#)mklocale.1 8.2 (Berkeley) 4/18/94
36 .\" $FreeBSD: src/usr.bin/mklocale/mklocale.1,v 1.7.2.5 2003/02/24 23:04:39 trhodes Exp $
37 .\" $DragonFly: src/usr.bin/mklocale/mklocale.1,v 1.4 2005/03/24 12:48:04 swildner Exp $
44 .Nd make LC_CTYPE locale files
49 .Ar "> language/LC_CTYPE"
60 source file from standard input and produces a
62 binary file on standard output suitable for placement in
63 .Pa /usr/share/locale/ Ns Ar language Ns Pa /LC_CTYPE .
68 It consists of a series of lines which start with a keyword and have
69 associated data following. C style comments are used
70 to place comments in the file.
72 Following options are available:
73 .Bl -tag -width indent
75 Turns on debugging messages.
80 Besides the keywords which will be listed below,
81 the following are valid tokens in
83 .Bl -tag -width ".Ar literal"
87 may be any of the following:
88 .Bl -tag -width ".Ar 0x[0-9a-z]*"
107 A hexadecimal number representing a rune code.
109 An octal number representing a rune code.
111 A decimal number representing a rune code.
114 A string enclosed in double quotes (").
120 Used to indicate ranges.
122 The follow characters are taken literally:
123 .Bl -tag -width ".Dv <\|\|(\|\|["
125 Used to start a mapping. All are equivalent.
127 Used to end a mapping. All are equivalent.
129 Used as a delimiter in mappings.
133 Key words which should only appear once are:
134 .Bl -tag -width PHONOGRAM
138 which indicates the encoding mechanism to be used for this locale.
139 The current encodings are:
142 No translation and the default.
144 .Dv "Universal character set Transformation Format"
146 .Tn "Plan 9 from Bell Labs" .
147 This is the preferred encoding.
150 encoding as used by several
155 PRC national standard for encoding of Chinese text.
157 Older PRC national standard for encoding Chinese text.
159 A widely used encoding method for Chinese text,
160 backwards compatible with GB\ 2312-1980.
162 The method of encoding Japanese used by Microsoft,
163 loosely based on JIS.
169 No translation and the default.
172 .Dq "Universal character set Transformation Format"
174 .Tn "Plan 9 from Bell Labs" .
178 transformation format of
181 as defined by RFC 2279.
184 This keyword must be followed by a single tab or space character,
185 after which encoding specific data is placed.
188 encoding requires variable data.
194 The following keywords may appear multiple times and have the following
196 .Bl -tag -width ".Dv <RUNE1 THRU RUNEn : RUNE2>" -offset indent
201 .It Dv <RUNE1 THRU RUNEn : RUNE2>
212 .Bl -tag -width ".Dv PHONOGRAM"
214 Defines the tolower mappings.
216 is the lower case representation of
219 Defines the toupper mappings.
221 is the upper case representation of
224 Defines a map from runes to their digit value.
226 is the integer value represented by
228 For example, the ASCII character
230 would map to the decimal value 0.
231 Only values up to 255
235 The following keywords may appear multiple times and have the following
237 .Bl -tag -width ".Dv RUNE1 THRU RUNEn" -offset indent
239 This rune has the property defined by the keyword.
240 .It Dv "RUNE1 THRU RUNEn"
241 All the runes between and including
245 have the property defined by the keyword.
247 .Bl -tag -width ".Dv PHONOGRAM"
249 Defines runes which are alphabetic, printable and graphic.
251 Defines runes which are control characters.
253 Defines runes which are decimal digits, printable and graphic.
255 Defines runes which are graphic and printable.
257 Defines runes which are lower case, printable and graphic.
259 Defines runes which are punctuation, printable and graphic.
261 Defines runes which are spaces.
263 Defines runes which are upper case, printable and graphic.
265 Defines runes which are hexadecimal digits, printable and graphic.
267 Defines runes which are blank.
269 Defines runes which are printable.
271 Defines runes which are ideograms, printable and graphic.
273 Defines runes which are special characters, printable and graphic.
275 Defines runes which are phonograms, printable and graphic.
277 Defines runes with display width 0.
279 Defines runes with display width 1.
281 Defines runes with display width 2.
283 Defines runes with display width 3.
286 If no display width explicitly defined, width 1 assumed
287 for printable runes by default.
302 utility is overly simplistic.
306 utility first appeared in