1 .\" $NetBSD: src/usr.bin/mklocale/mklocale.1,v 1.13 2004/01/24 17:03:26 wiz Exp $
2 .\" FreeBSD: src/usr.bin/mklocale/mklocale.1,v 1.6 1999/09/20 09:15:21 phantom Exp
3 .\" $DragonFly: src/usr.bin/mklocale/mklocale.1,v 1.5 2005/04/21 16:36:35 joerg Exp $
5 .\" Copyright (c) 1993, 1994
6 .\" The Regents of the University of California. All rights reserved.
8 .\" This code is derived from software contributed to Berkeley by
9 .\" Paul Borman at Krystal Technologies.
11 .\" Redistribution and use in source and binary forms, with or without
12 .\" modification, are permitted provided that the following conditions
14 .\" 1. Redistributions of source code must retain the above copyright
15 .\" notice, this list of conditions and the following disclaimer.
16 .\" 2. Redistributions in binary form must reproduce the above copyright
17 .\" notice, this list of conditions and the following disclaimer in the
18 .\" documentation and/or other materials provided with the distribution.
19 .\" 3. 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
42 .Nd make LC_CTYPE locale files
60 source file from standard input and produces an
62 binary file on standard output suitable for placement in
63 .Pa /usr/share/locale/\*[Lt]language\*[Gt]/LC_CTYPE .
68 It consists of a series of lines which start with a keyword and have
69 associated data following.
70 C style comments are used
71 to place comments in the file.
73 Following options are available:
76 Turns on debugging messages.
81 Besides the keywords which will be listed below,
82 the following are valid tokens in
84 .Bl -tag -width literal
88 may be any of the following:
89 .Bl -tag -width 0x[0-9a-z]*
108 A hexadecimal number representing a rune code.
110 An octal number representing a rune code.
112 A decimal number representing a rune code.
115 A string enclosed in double quotes (").
121 Used to indicate ranges.
123 The follow characters are taken literally:
124 .Bl -tag -width "\*[Lt]\|\|(\|\|["
125 .It Dv "\*[Lt]\|(\|["
126 Used to start a mapping.
128 .It Dv "\*[Gt]\|\^)\|]"
129 Used to end a mapping.
132 Used as a delimiter in mappings.
136 Key words which should only appear once are:
137 .Bl -tag -width PHONOGRAM
141 which indicates the encoding mechanism to be used for this locale.
142 The current encodings are:
145 No translation and the default.
147 .Dv "Universal character set Transformation Format"
149 .Nm "Plan 9 from Bell Labs" .
152 encoding as used by several
158 This keyword must be followed by a single tab or space character,
159 after which encoding specific data is placed.
162 encoding requires variable data.
171 The following keywords may appear multiple times and have the following
174 .Bl -tag -width "XXRUNE1 THRU RUNEn : RUNE2XX"
175 .It Aq Dv RUNE1 RUNE2
179 .It Aq Dv RUNE1 THRU RUNEn : RUNE2
191 .Bl -tag -width PHONOGRAM
193 Defines the tolower mappings.
195 is the lower case representation of
198 Defines the toupper mappings.
200 is the upper case representation of
203 Defines a map from runes to their digit value.
205 is the integer value represented by
207 For example, the ASCII character
209 would map to the decimal value 0.
210 Only values up to 255 are allowed.
213 The following keywords may appear multiple times and have the following
215 .Bl -tag -width "RUNE1 THRU RUNEn"
217 This rune has the property defined by the keyword.
218 .It Dv "RUNE1 THRU RUNEn"
219 All the runes between and including
223 have the property defined by the keyword.
225 .Bl -tag -width PHONOGRAM
227 Defines runes which are alphabetic, printable, and graphic.
229 Defines runes which are control characters.
231 Defines runes which are decimal digits, printable, and graphic.
233 Defines runes which are graphic and printable.
235 Defines runes which are lower case, printable, and graphic.
237 Defines runes which are punctuation, printable, and graphic.
239 Defines runes which are spaces.
241 Defines runes which are upper case, printable, and graphic.
243 Defines runes which are hexadecimal digits, printable, and graphic.
245 Defines runes which are blank.
247 Defines runes which are printable.
249 Defines runes which are ideograms, printable, and graphic.
251 Defines runes which are special characters, printable, and graphic.
253 Defines runes which are phonograms, printable, and graphic.
255 Defines runes with specific glyph width.
259 Controls character set for subsequent runes.
262 .\" locale definitions.
273 utility first appeared in
278 utility is overly simplistic.
282 and its file format, which is more standard.