Penguin
Recent Changes
Annotated edit history of locale(5) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 locale
2 !!!locale
3 NAME
4 DESCRIPTION
5 SYNTAX
6 FILES
7 BUGS
8 AUTHOR
9 CONFORMING TO
10 SEE ALSO
11 ----
12 !!NAME
13
14
15 locale - Describes a locale definition file
16 !!DESCRIPTION
17
18
19 The __locale__ definition files contains all the
20 information that the __localedef(1)__ command needs to
21 convert it into the binary locale database.
22
23
24 The definition files consist of sections which each describe
25 a locale category in detail.
26 !!SYNTAX
27
28
29 The locale definition file starts with a header, that may
30 consist of the following keywords:
31
32
33 ''''
34
35
36 is followed by a character that should be used as the
37 escape-character for the rest of the file to mark characters
38 that should be interpreted in a special way. It defaults to
39 the backslash ( __\__ ).
40
41
42 ''''
43
44
45 is followed by a character that will be used as the
46 comment-character for the rest of the file. It defaults to
47 the number sign ( __#__ ).
48
49
50 The locale definitions is divided it one part for each
51 locale category. Each part can be copied from another
52 existing locale or can be defined from scratch. If the
53 category should be copied, the only valid keyword in the
54 definition is __copy__ followed by the name of the locale
55 which should be copied.
56
57
58 __LC_CTYPE__
59
60
61 __LC_CTYPE__ category starts with the string
62 ''LC_CTYPE'' in the first column.
63
64
65 There are the following keywords allowed:
66
67
68 ''upper''
69
70
71 followed by a list of uppercase letters. The letters
72 __A__ trough __Z__ are included automatically.
73 Characters also specified as __cntrl, digit, punct,__ or
74 __space__ are not allowed.
75
76
77 ''lower''
78
79
80 followed by a list of lowercase letters. The letters
81 __a__ trough __z__ are included automatically.
82 Characters also specified as __cntrl, digit, punct,__ or
83 __space__ are not allowed.
84
85
86 ''alpha''
87
88
89 followed by a list of letters. All character specified as
90 either __upper__ or __lower__ are automatically
91 included. Characters also specified as __cntrl, digit,
92 punct,__ or __space__ are not allowed.
93
94
95 ''digit''
96
97
98 followed by the characters classified as numeric digits.
99 Only the digits __0__ trough __9__ are allowed. They
100 are included by default in this class.
101
102
103 ''space''
104
105
106 followed by a list of characters defined as white-space
107 characters. Characters also specified as __upper, lower,
108 alpha, digit, graph,__ or __xdigit__ are not allowed.
109 The characters __
110 __
111 and ____ are automatically
112 included.
113
114
115 ''cntrl''
116
117
118 followed by a list of control characters. Characters also
119 specified as __upper, lower, alpha, digit, punct, graph,
120 print__ or __xdigit__ are not allowed.
121
122
123 ''punct''
124
125
126 followed by a list of punctuation characters. Characters
127 also specified as __upper, lower, alpha, digit, cntrl,
128 xdigit__ or the ____ character are not
129 allowed.
130
131
132 ''graph''
133
134
135 followed by a list of printable characters, not including
136 the ____ character. The characters defined
137 as __upper, lower, alpha, digit, xdigit__ and
138 __punct__ are automatically included. Characters also
139 specified as __cntrl__ are not allowed.
140
141
142 ''print''
143
144
145 followed by a list of printable characters, including the
146 ____ character. The characters defined as
147 __upper, lower, alpha, digit, xdigit, punct__ and the
148 ____ character are automatically included.
149 Characters also specified as __cntrl__ are not
150 allowed.
151
152
153 ''xdigit''
154
155
156 followed by a list of characters classified as hexadecimal
157 digits. The decimal digits must be included followed by one
158 or more set of six characters in ascending order. The
159 following characters are included by default: __0__
160 trough __9, a__ trough __f, A__ trough
161 __F.__
162
163
164 ''blank''
165
166
167 followed by a list of characters classified as __blank.__
168 The characters ____ and ____
169 are automatically included.
170
171
172 ''toupper''
173
174
175 followed by a list of mappings from lowercase to uppercase
176 letters. Each mapping is a pair of a lowercase and an
177 uppercase letter separated with a __,__ and enclosed in
178 parentheses. The members of the list are separated with
179 semicolons.
180
181
182 ''tolower''
183
184
185 followed by a list of mappings from uppercase to lowercase
186 letters. If the keyword tolower is not present, the reverse
187 of the toupper list is used.
188
189
190 The __LC_CTYPE__ definition ends with the string ''END
191 LC_CYTPE.''
192
193
194 __LC_COLLATE__
195
196
197 The __LC_COLLATE__ category defines the rules for
198 collating characters. Due to limitations of libc not all
199 POSIX-options are implemented.
200
201
202 The definition starts with the string __LC_COLLATE__ in
203 the first column.
204
205
206 There are the following keywords allowed:
207
208
209 ''collating-element''
210
211
212 ''collating-symbol''
213
214
215 The order-definition starts with a line:
216
217
218 ''order_start''
219
220
221 followed by a list of keywords out of __forward,
222 backward__ or __position.__ The order definition
223 consists of lines that describe the order and is terminated
224 with the keyword
225
226
227 ''order_end.''
228
229
230 For more details see the sources in __/usr/lib/nls/src__
231 notably the examples __POSIX, Example__ and
232 __Example2__
233
234
235 The __LC_COLLATE__ definition ends with the string ''END
236 LC_COLLATE.''
237
238
239 __LC_MONETARY__
240
241
242 The definition starts with the string __LC_MONETARY__ in
243 the first column.
244
245
246 There are the following keywords allowed:
247
248
249 ''int_curr_symbol''
250
251
252 followed by the international currency symbol. This must be
253 a four character string containing the international
254 currency symbol as defined by the ISO 4217 standard (three
255 characters) followed by a separator.
256
257
258 ''currency_symbol''
259
260
261 followed by the local currency symbol.
262
263
264 ''mon_decimal_point''
265
266
267 followed by the string that will be used as the decimal
268 delimiter when formatting monetary quantities.
269
270
271 ''mon_thousands_sep''
272
273
274 followed by the string that will be used as a group
275 separator when formatting monetary quantities.
276
277
278 ''mon_grouping''
279
280
281 followed by a string that describes the formatting of
282 numeric quantities.
283
284
285 ''positive_sign''
286
287
288 followed by a string that is used to indicate a positive
289 sign for monetary quantities.
290
291
292 ''negative_sign''
293
294
295 followed by a string that is used to indicate a negative
296 sign for monetary quantities.
297
298
299 ''int_frac_digits''
300
301
302 followed by the number of fractional digits that should be
303 used when formatting with the
304 __int_curr_symbol.__
305
306
307 ''frac_digits''
308
309
310 followed by the number of fractional digits that should be
311 used when formatting with the
312 __currency_symbol.__
313
314
315 ''p_cs_precedes''
316
317
318 followed by an integer set to __1__ if the
319 ''currency_symbol'' or ''int_curr_symbol'' should
320 precede the formatted monetary quantity or set to __0__
321 if the symbol succeeds the value.
322
323
324 ''p_sep_by_space''
325
326
327 followed by an integer.
328
329
330 __0__
331
332
333 means that no space should be printed between the symbol and
334 the value.
335
336
337 __1__
338
339
340 means that a space should be printed between the symbol and
341 the value.
342
343
344 __2__
345
346
347 means that a space should be printed between the symbol and
348 the sign string, if adjacent.
349
350
351 ''n_cs_precedes''
352
353
354 __0__
355
356
357 - the symbol succeeds the value
358
359
360 __1__
361
362
363 - the symbol precedes the value
364
365
366 ''n_sep_by_space''
367
368
369 An integer set to __0__ if no space separates the
370 ''currency_symbol'' or ''int_curr_symbol'' from the
371 value for a negative monetary quantity, set to __1__ if a
372 space separates the symbol from the value and set to
373 __2__ if a space separates the symbol and the sign
374 string, if adjacent.
375
376
377 ''p_sign_posn''
378
379
380 __0__
381
382
383 Parentheses enclose the quantity and the
384 ''currency_symbol'' or
385 ''int_curr_symbol.''
386
387
388 __1__
389
390
391 The sign string precedes the quantity and the
392 ''currency_symbol'' or the
393 ''int_curr_symbol.''
394
395
396 __2__
397
398
399 The sign string succeeds the quantity and the
400 ''currency_symbol'' or the
401 ''int_curr_symbol.''
402
403
404 __3__
405
406
407 The sign string precedes the ''currency_symbol'' or the
408 ''int_curr_symbol.''
409
410
411 __4__
412
413
414 The sign string succeeds the ''currency_symbol'' or the
415 ''int_curr_symbol.''
416
417
418 ''n_sign_posn''
419
420
421 __0__
422
423
424 Parentheses enclose the quantity and the
425 ''currency_symbol'' or
426 ''int_curr_symbol.''
427
428
429 __1__
430
431
432 The sign string precedes the quantity and the
433 ''currency_symbol'' or the
434 ''int_curr_symbol.''
435
436
437 __2__
438
439
440 The sign string succeeds the quantity and the
441 ''currency_symbol'' or the
442 ''int_curr_symbol.''
443
444
445 __3__
446
447
448 The sign string precedes the ''currency_symbol'' or the
449 ''int_curr_symbol.''
450
451
452 __4__
453
454
455 The sign string succeeds the ''currency_symbol'' or the
456 ''int_curr_symbol.''
457
458
459 The __LC_MONETARY__ definition ends with the string
460 ''END LC_MONETARY.''
461
462
463 __LC_NUMERIC__
464
465
466 The definition starts with the string __LC_NUMERIC__ in
467 the first column.
468
469
470 There are the following keywords allowed:
471
472
473 ''decimal_point''
474
475
476 followed by the string that will be used as the decimal
477 delimiter when formatting numeric quantities.
478
479
480 ''thousands_sep''
481
482
483 followed by the string that will be used as a group
484 separator when formatting numeric quantities.
485
486
487 ''grouping''
488
489
490 followed by a string that describes the formatting of
491 numeric quantities.
492
493
494 The __LC_NUMERIC__ definition ends with the string ''END
495 LC_NUMERIC.''
496
497
498 __LC_TIME__
499
500
501 The definition starts with the string __LC_TIME__ in the
502 first column.
503
504
505 There are the following keywords allowed:
506
507
508 ''abday''
509
510
511 followed by a list of abbreviated weekday names. The list
512 starts with the Sunday or it's translation.
513
514
515 ''day''
516
517
518 followed by a list of weekday names. The list starts with
519 the Sunday.
520
521
522 ''abmon''
523
524
525 followed by a list of abbreviated month names.
526
527
528 ''mon''
529
530
531 followed by a list of month names.
532
533
534 ''am_pm''
535
536
537 The appropriate representation of the __am__ and
538 __pm__ strings.
539
540
541 ''d_t_fmt''
542
543
544 The appropriate date and time format.
545
546
547 ''d_fmt''
548
549
550 The appropriate date format.
551
552
553 ''t_fmt''
554
555
556 The appropriate time format.
557
558
559 ''t_fmt_ampm''
560
561
562 The appropriate time format when using 12h clock
563 format.
564
565
566 The __LC_TIME__ definition ends with the string ''END
567 LC_TIME.''
568
569
570 __LC_MESSAGES__
571
572
573 The definition starts with the string __LC_MESSAGES__ in
574 the first column.
575
576
577 There are the following keywords allowed:
578
579
580 ''yesexpr''
581
582
583 followed by a regular expression that describes possible
584 yes-responses.
585
586
587 ''noexpr''
588
589
590 followed by a regular expression that describes possible
591 no-responses.
592
593
594 The __LC_MESSAGES__ definition ends with the string
595 ''END LC_MESSAGES.''
596
597
598 See the POSIX.2 standard for details.
599 !!FILES
600
601
602 /usr/lib/locale/ - database for the current locale setting
603 of that category /usr/lib/nls/charmap/* -
604 charmap-files
605 !!BUGS
606
607
608 The manpage isn't complete.
609 !!AUTHOR
610
611
612 Jochen Hein (Hein@Student.TU-Clausthal.de)
613 !!CONFORMING TO
614
615
616 POSIX.2
617 !!SEE ALSO
618
619
620 setlocale(3), localeconv(3),
621 charmap(5), locale(1),
622 localedef(1)
623 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.