]>
Commit | Line | Data |
---|---|---|
fea681da | 1 | .\" Copyright (C) 1994 Jochen Hein (Hein@Student.TU-Clausthal.de) |
33af8501 | 2 | .\" Copyright (C) 2008 Petr Baudis (pasky@suse.cz) |
ca56bbbc | 3 | .\" Copyright (C) 2014 Michael Kerrisk <mtk@manpages@gmail.com> |
fea681da | 4 | .\" |
e4a74ca8 | 5 | .\" SPDX-License-Identifier: GPL-2.0-or-later |
fea681da | 6 | .\" |
33af8501 MK |
7 | .\" 2008-06-17 Petr Baudis <pasky@suse.cz> |
8 | .\" LC_TIME: Describe first_weekday and first_workday | |
9 | .\" | |
4c1c5274 | 10 | .TH locale 5 (date) "Linux man-pages (unreleased)" |
fea681da | 11 | .SH NAME |
f68512e9 | 12 | locale \- describes a locale definition file |
fea681da | 13 | .SH DESCRIPTION |
c13182ef | 14 | The |
fea681da | 15 | .B locale |
6fae67a4 | 16 | definition file contains all the information that the |
c13182ef | 17 | .BR localedef (1) |
fea681da | 18 | command needs to convert it into the binary locale database. |
2dad4c59 | 19 | .PP |
fea681da MK |
20 | The definition files consist of sections which each describe a |
21 | locale category in detail. | |
7bc58733 | 22 | See |
ab601e67 | 23 | .BR locale (7) |
7bc58733 | 24 | for additional details for these categories. |
23618627 | 25 | .SS Syntax |
fea681da MK |
26 | The locale definition file starts with a header that may consist |
27 | of the following keywords: | |
28 | .TP | |
8f292910 | 29 | .I escape_char |
fea681da MK |
30 | is followed by a character that should be used as the |
31 | escape-character for the rest of the file to mark characters that | |
c13182ef | 32 | should be interpreted in a special way. |
d1a71985 | 33 | It defaults to the backslash (\e). |
fea681da | 34 | .TP |
8f292910 | 35 | .I comment_char |
fea681da | 36 | is followed by a character that will be used as the |
c13182ef | 37 | comment-character for the rest of the file. |
74d32233 | 38 | It defaults to the number sign (#). |
fea681da MK |
39 | .PP |
40 | The locale definition has one part for each locale category. | |
41 | Each part can be copied from another existing locale or | |
c13182ef MK |
42 | can be defined from scratch. |
43 | If the category should be copied, | |
fea681da | 44 | the only valid keyword in the definition is |
74e03e90 | 45 | .I copy |
f809007b MM |
46 | followed by the name of the locale in double quotes which should be |
47 | copied. | |
af7ad104 MM |
48 | The exceptions for this rule are |
49 | .B LC_COLLATE | |
50 | and | |
51 | .B LC_CTYPE | |
52 | where a | |
74e03e90 | 53 | .I copy |
35a2f886 | 54 | statement can be followed by locale-specific rules and selected overrides. |
f809007b | 55 | .PP |
a581f759 MM |
56 | When defining a locale or a category from scratch, an existing system- |
57 | provided locale definition file should be used as a reference to follow | |
58 | common glibc conventions. | |
ca56bbbc MK |
59 | .SS Locale category sections |
60 | The following category sections are defined by POSIX: | |
cdede5cd | 61 | .IP \[bu] 3 |
ca56bbbc | 62 | .B LC_CTYPE |
cdede5cd | 63 | .IP \[bu] |
ca56bbbc | 64 | .B LC_COLLATE |
cdede5cd | 65 | .IP \[bu] |
8ed1a976 | 66 | .B LC_MESSAGES |
cdede5cd | 67 | .IP \[bu] |
ca56bbbc | 68 | .B LC_MONETARY |
cdede5cd | 69 | .IP \[bu] |
ca56bbbc | 70 | .B LC_NUMERIC |
cdede5cd | 71 | .IP \[bu] |
ca56bbbc | 72 | .B LC_TIME |
ca56bbbc | 73 | .PP |
b324e17d | 74 | In addition, since glibc 2.2, |
ca56bbbc | 75 | the GNU C library supports the following nonstandard categories: |
cdede5cd | 76 | .IP \[bu] 3 |
ca56bbbc | 77 | .B LC_ADDRESS |
cdede5cd | 78 | .IP \[bu] |
ca56bbbc | 79 | .B LC_IDENTIFICATION |
cdede5cd | 80 | .IP \[bu] |
ca56bbbc | 81 | .B LC_MEASUREMENT |
cdede5cd | 82 | .IP \[bu] |
ca56bbbc | 83 | .B LC_NAME |
cdede5cd | 84 | .IP \[bu] |
ca56bbbc | 85 | .B LC_PAPER |
cdede5cd | 86 | .IP \[bu] |
ca56bbbc | 87 | .B LC_TELEPHONE |
f809007b MM |
88 | .PP |
89 | See | |
90 | .BR locale (7) | |
984bf8fc | 91 | for a more detailed description of each category. |
73cb5f18 | 92 | .SS LC_ADDRESS |
5f7504ef | 93 | The definition starts with the string |
b8a2e38e | 94 | .I LC_ADDRESS |
73cb5f18 | 95 | in the first column. |
2dad4c59 | 96 | .PP |
73cb5f18 | 97 | The following keywords are allowed: |
73cb5f18 MK |
98 | .TP |
99 | .I postal_fmt | |
100 | followed by a string containing field descriptors that define | |
101 | the format used for postal addresses in the locale. | |
102 | The following field descriptors are recognized: | |
73cb5f18 | 103 | .RS |
9bbaafcc MM |
104 | .TP |
105 | %n | |
106 | Person's name, possibly constructed with the | |
107 | .B LC_NAME | |
108 | .I name_fmt | |
109 | keyword (since glibc 2.24). | |
6aeda2ec | 110 | .TP 4 |
73cb5f18 MK |
111 | %a |
112 | Care of person, or organization. | |
113 | .TP | |
114 | %f | |
115 | Firm name. | |
116 | .TP | |
117 | %d | |
118 | Department name. | |
119 | .TP | |
120 | %b | |
121 | Building name. | |
122 | .TP | |
123 | %s | |
124 | Street or block (e.g., Japanese) name. | |
125 | .TP | |
126 | %h | |
127 | House number or designation. | |
128 | .TP | |
129 | %N | |
130 | Insert an end-of-line if the previous descriptor's value was not an empty | |
131 | string; otherwise ignore. | |
132 | .TP | |
133 | %t | |
134 | Insert a space if the previous descriptor's value was not an empty string; | |
135 | otherwise ignore. | |
136 | .TP | |
137 | %r | |
138 | Room number, door designation. | |
139 | .TP | |
140 | %e | |
141 | Floor number. | |
142 | .TP | |
143 | %C | |
8f292910 MM |
144 | Country designation, from the |
145 | .I country_post | |
146 | keyword. | |
9bbaafcc MM |
147 | .TP |
148 | %l | |
149 | Local township within town or city (since glibc 2.24). | |
73cb5f18 MK |
150 | .TP |
151 | %z | |
152 | Zip number, postal code. | |
153 | .TP | |
154 | %T | |
155 | Town, city. | |
156 | .TP | |
157 | %S | |
158 | State, province, or prefecture. | |
159 | .TP | |
160 | %c | |
161 | Country, as taken from data record. | |
162 | .PP | |
b957f81f AC |
163 | Each field descriptor may have an \[aq]R\[aq] after |
164 | the \[aq]%\[aq] to specify that the | |
73cb5f18 MK |
165 | information is taken from a Romanized version string of the |
166 | entity. | |
167 | .RE | |
73cb5f18 MK |
168 | .TP |
169 | .I country_name | |
170 | followed by the country name in the language of the current document | |
5f7504ef | 171 | (e.g., "Deutschland" for the |
74e03e90 | 172 | .B de_DE |
73cb5f18 MK |
173 | locale). |
174 | .TP | |
175 | .I country_post | |
176 | followed by the abbreviation of the country (see CERT_MAILCODES). | |
177 | .TP | |
178 | .I country_ab2 | |
179 | followed by the two-letter abbreviation of the country (ISO 3166). | |
180 | .TP | |
181 | .I country_ab3 | |
182 | followed by the three-letter abbreviation of the country (ISO 3166). | |
183 | .TP | |
184 | .I country_num | |
a581f759 | 185 | followed by the numeric country code (ISO 3166). |
73cb5f18 MK |
186 | .TP |
187 | .I country_car | |
927a5da2 | 188 | followed by the international license plate country code. |
73cb5f18 MK |
189 | .TP |
190 | .I country_isbn | |
d8826256 | 191 | followed by the ISBN code (for books). |
73cb5f18 MK |
192 | .TP |
193 | .I lang_name | |
194 | followed by the language name in the language of the current document. | |
195 | .TP | |
196 | .I lang_ab | |
197 | followed by the two-letter abbreviation of the language (ISO 639). | |
198 | .TP | |
199 | .I lang_term | |
e6812b0d | 200 | followed by the three-letter abbreviation of the language (ISO 639-2/T). |
73cb5f18 MK |
201 | .TP |
202 | .I lang_lib | |
e6812b0d | 203 | followed by the three-letter abbreviation of the language for library |
c33a8494 MK |
204 | use (ISO 639-2/B). |
205 | Applications should in general prefer | |
b100ab55 | 206 | .I lang_term |
e6812b0d MM |
207 | over |
208 | .IR lang_lib . | |
73cb5f18 MK |
209 | .PP |
210 | The | |
211 | .B LC_ADDRESS | |
212 | definition ends with the string | |
213 | .IR "END LC_ADDRESS" . | |
fea681da | 214 | .SS LC_CTYPE |
5f7504ef | 215 | The definition starts with the string |
b8a2e38e | 216 | .I LC_CTYPE |
fea681da | 217 | in the first column. |
2dad4c59 | 218 | .PP |
c85b9034 | 219 | The following keywords are allowed: |
fea681da MK |
220 | .TP |
221 | .I upper | |
c13182ef MK |
222 | followed by a list of uppercase letters. |
223 | The letters | |
fea681da | 224 | .B A |
b30df7b1 | 225 | through |
fea681da | 226 | .B Z |
c13182ef MK |
227 | are included automatically. |
228 | Characters also specified as | |
fea681da MK |
229 | .BR cntrl , |
230 | .BR digit , | |
231 | .BR punct , | |
232 | or | |
233 | .B space | |
234 | are not allowed. | |
fea681da MK |
235 | .TP |
236 | .I lower | |
c13182ef MK |
237 | followed by a list of lowercase letters. |
238 | The letters | |
fea681da | 239 | .B a |
b878f418 | 240 | through |
fea681da | 241 | .B z |
c13182ef MK |
242 | are included automatically. |
243 | Characters also specified as | |
fea681da MK |
244 | .BR cntrl , |
245 | .BR digit , | |
246 | .BR punct , | |
247 | or | |
248 | .B space | |
249 | are not allowed. | |
fea681da MK |
250 | .TP |
251 | .I alpha | |
c13182ef MK |
252 | followed by a list of letters. |
253 | All character specified as either | |
fea681da | 254 | .B upper |
c13182ef | 255 | or |
fea681da | 256 | .B lower |
c13182ef MK |
257 | are automatically included. |
258 | Characters also specified as | |
fea681da MK |
259 | .BR cntrl , |
260 | .BR digit , | |
261 | .BR punct , | |
262 | or | |
263 | .B space | |
264 | are not allowed. | |
fea681da MK |
265 | .TP |
266 | .I digit | |
c13182ef MK |
267 | followed by the characters classified as numeric digits. |
268 | Only the | |
269 | digits | |
270 | .B 0 | |
b878f418 | 271 | through |
c13182ef MK |
272 | .B 9 |
273 | are allowed. | |
274 | They are included by default in this class. | |
fea681da MK |
275 | .TP |
276 | .I space | |
277 | followed by a list of characters defined as white-space | |
c13182ef MK |
278 | characters. |
279 | Characters also specified as | |
fea681da MK |
280 | .BR upper , |
281 | .BR lower , | |
282 | .BR alpha , | |
283 | .BR digit , | |
284 | .BR graph , | |
285 | or | |
286 | .B xdigit | |
c13182ef MK |
287 | are not allowed. |
288 | The characters | |
fea681da MK |
289 | .BR <space> , |
290 | .BR <form-feed> , | |
291 | .BR <newline> , | |
292 | .BR <carriage-return> , | |
293 | .BR <tab> , | |
294 | and | |
295 | .B <vertical-tab> | |
296 | are automatically included. | |
fea681da MK |
297 | .TP |
298 | .I cntrl | |
299 | followed by a list of control characters. | |
300 | Characters also specified as | |
301 | .BR upper , | |
302 | .BR lower , | |
303 | .BR alpha , | |
304 | .BR digit , | |
305 | .BR punct , | |
306 | .BR graph , | |
307 | .BR print , | |
308 | or | |
309 | .B xdigit | |
310 | are not allowed. | |
311 | .TP | |
312 | .I punct | |
c13182ef MK |
313 | followed by a list of punctuation characters. |
314 | Characters also | |
fea681da MK |
315 | specified as |
316 | .BR upper , | |
317 | .BR lower , | |
318 | .BR alpha , | |
319 | .BR digit , | |
320 | .BR cntrl , | |
321 | .BR xdigit , | |
322 | or the | |
323 | .B <space> | |
324 | character are not allowed. | |
fea681da MK |
325 | .TP |
326 | .I graph | |
327 | followed by a list of printable characters, not including the | |
328 | .B <space> | |
c13182ef MK |
329 | character. |
330 | The characters defined as | |
fea681da MK |
331 | .BR upper , |
332 | .BR lower , | |
333 | .BR alpha , | |
334 | .BR digit , | |
335 | .BR xdigit , | |
336 | and | |
c13182ef | 337 | .B punct |
fea681da MK |
338 | are automatically included. |
339 | Characters also specified as | |
340 | .B cntrl | |
341 | are not allowed. | |
fea681da MK |
342 | .TP |
343 | .I print | |
344 | followed by a list of printable characters, including the | |
345 | .B <space> | |
c13182ef MK |
346 | character. |
347 | The characters defined as | |
fea681da MK |
348 | .BR upper , |
349 | .BR lower , | |
350 | .BR alpha , | |
351 | .BR digit , | |
352 | .BR xdigit , | |
353 | .BR punct , | |
354 | and the | |
355 | .B <space> | |
356 | character are automatically included. | |
357 | Characters also specified as | |
358 | .B cntrl | |
359 | are not allowed. | |
fea681da MK |
360 | .TP |
361 | .I xdigit | |
362 | followed by a list of characters classified as hexadecimal | |
c13182ef MK |
363 | digits. |
364 | The decimal digits must be included followed by one or | |
365 | more set of six characters in ascending order. | |
366 | The following | |
fea681da MK |
367 | characters are included by default: |
368 | .B 0 | |
b878f418 | 369 | through |
fea681da MK |
370 | .BR 9 , |
371 | .B a | |
b878f418 | 372 | through |
fea681da MK |
373 | .BR f , |
374 | .B A | |
b878f418 | 375 | through |
fea681da | 376 | .BR F . |
fea681da MK |
377 | .TP |
378 | .I blank | |
c13182ef | 379 | followed by a list of characters classified as |
fea681da MK |
380 | .BR blank . |
381 | The characters | |
382 | .B <space> | |
c13182ef | 383 | and |
fea681da MK |
384 | .B <tab> |
385 | are automatically included. | |
fea681da | 386 | .TP |
e4bcd971 MM |
387 | .I charclass |
388 | followed by a list of locale-specific character class names | |
389 | which are then to be defined in the locale. | |
390 | .TP | |
fea681da MK |
391 | .I toupper |
392 | followed by a list of mappings from lowercase to uppercase | |
c13182ef MK |
393 | letters. |
394 | Each mapping is a pair of a lowercase and an uppercase letter | |
395 | separated with a | |
fea681da | 396 | .B , |
c13182ef | 397 | and enclosed in parentheses. |
fea681da MK |
398 | .TP |
399 | .I tolower | |
400 | followed by a list of mappings from uppercase to lowercase | |
c13182ef MK |
401 | letters. |
402 | If the keyword tolower is not present, the reverse of the | |
fea681da | 403 | toupper list is used. |
ae91a0d6 | 404 | .TP |
b3834a45 | 405 | .I map totitle |
f863ce4f MM |
406 | followed by a list of mapping pairs of |
407 | characters and letters | |
408 | to be used in titles (headings). | |
409 | .TP | |
1f4f51b5 MM |
410 | .I class |
411 | followed by a locale-specific character class definition, | |
412 | starting with the class name followed by the characters | |
413 | belonging to the class. | |
414 | .TP | |
ae91a0d6 | 415 | .I charconv |
861c753a | 416 | followed by a list of locale-specific character mapping names |
ae91a0d6 | 417 | which are then to be defined in the locale. |
89257a53 MM |
418 | .TP |
419 | .I outdigit | |
420 | followed by a list of alternate output digits for the locale. | |
0ef30d8d MM |
421 | .TP |
422 | .I map to_inpunct | |
423 | followed by a list of mapping pairs of | |
424 | alternate digits and separators | |
425 | for input digits for the locale. | |
426 | .TP | |
427 | .I map to_outpunct | |
428 | followed by a list of mapping pairs of | |
429 | alternate separators | |
430 | for output for the locale. | |
4e3b0c16 MM |
431 | .TP |
432 | .I translit_start | |
433 | marks the start of the transliteration rules section. | |
434 | The section can contain the | |
435 | .I include | |
436 | keyword in the beginning followed by | |
35a2f886 | 437 | locale-specific rules and overrides. |
4e3b0c16 MM |
438 | Any rule specified in the locale file |
439 | will override any rule | |
440 | copied or included from other files. | |
441 | In case of duplicate rule definitions in the locale file, | |
442 | only the first rule is used. | |
2dad4c59 | 443 | .IP |
4e3b0c16 MM |
444 | A transliteration rule consist of a character to be transliterated |
445 | followed by a list of transliteration targets separated by semicolons. | |
446 | The first target which can be presented in the target character set | |
447 | is used, if none of them can be used the | |
448 | .I default_missing | |
449 | character will be used instead. | |
450 | .TP | |
451 | .I include | |
452 | in the transliteration rules section includes | |
453 | a transliteration rule file | |
b3834a45 | 454 | (and optionally a repertoire map file). |
4e3b0c16 | 455 | .TP |
6077885a | 456 | .I default_missing |
8cc4d071 MK |
457 | in the transliteration rules section |
458 | defines the default character to be used for | |
6077885a MM |
459 | transliteration where none of the targets cannot be presented |
460 | in the target character set. | |
461 | .TP | |
4e3b0c16 MM |
462 | .I translit_end |
463 | marks the end of the transliteration rules. | |
fea681da | 464 | .PP |
c13182ef | 465 | The |
fea681da | 466 | .B LC_CTYPE |
c13182ef | 467 | definition ends with the string |
49b3d955 | 468 | .IR "END LC_CTYPE" . |
fea681da | 469 | .SS LC_COLLATE |
c9aec10a MM |
470 | Note that glibc does not support all POSIX-defined options, |
471 | only the options described below are supported (as of glibc 2.23). | |
2dad4c59 | 472 | .PP |
fea681da | 473 | The definition starts with the string |
b8a2e38e | 474 | .I LC_COLLATE |
fea681da | 475 | in the first column. |
2dad4c59 | 476 | .PP |
c85b9034 | 477 | The following keywords are allowed: |
c9aec10a MM |
478 | .TP |
479 | .I coll_weight_max | |
480 | followed by the number representing used collation levels. | |
481 | This keyword is recognized but ignored by glibc. | |
fea681da | 482 | .TP |
cd415e73 | 483 | .I collating\-element |
84f36a95 MK |
484 | followed by the definition of a collating-element symbol |
485 | representing a multicharacter collating element. | |
fea681da | 486 | .TP |
cd415e73 | 487 | .I collating\-symbol |
84f36a95 MK |
488 | followed by the definition of a collating symbol |
489 | that can be used in collation order statements. | |
c9aec10a | 490 | .TP |
74e03e90 MM |
491 | .I define |
492 | followed by | |
493 | .B string | |
494 | to be evaluated in an | |
495 | .I ifdef | |
496 | .B string | |
497 | / | |
498 | .I else | |
499 | / | |
500 | .I endif | |
501 | construct. | |
502 | .TP | |
cd415e73 | 503 | .I reorder\-after |
c9aec10a MM |
504 | followed by a redefinition of a collation rule. |
505 | .TP | |
cd415e73 | 506 | .I reorder\-end |
c9aec10a MM |
507 | marks the end of the redefinition of a collation rule. |
508 | .TP | |
cd415e73 | 509 | .I reorde\r-sections\-after |
74e03e90 MM |
510 | followed by a script name to reorder listed scripts after. |
511 | .TP | |
cd415e73 | 512 | .I reorder\-sections\-end |
74e03e90 | 513 | marks the end of the reordering of sections. |
c9aec10a | 514 | .TP |
74e03e90 MM |
515 | .I script |
516 | followed by a declaration of a script. | |
c9aec10a | 517 | .TP |
cd415e73 | 518 | .I symbol\-equivalence |
c9aec10a MM |
519 | followed by a collating-symbol to be equivalent to another defined |
520 | collating-symbol. | |
fea681da | 521 | .PP |
c9aec10a | 522 | The collation rule definition starts with a line: |
fea681da MK |
523 | .TP |
524 | .I order_start | |
c85b9034 | 525 | followed by a list of keywords chosen from |
a5e0a0e4 MK |
526 | .BR forward , |
527 | .BR backward , | |
fea681da | 528 | or |
a5e0a0e4 | 529 | .BR position . |
c9aec10a MM |
530 | The order definition consists of lines that describe the collation |
531 | order and is terminated with the keyword | |
a5e0a0e4 | 532 | .IR order_end . |
fea681da | 533 | .PP |
c13182ef | 534 | The |
fea681da | 535 | .B LC_COLLATE |
c13182ef | 536 | definition ends with the string |
74d32233 | 537 | .IR "END LC_COLLATE" . |
25e04747 | 538 | .SS LC_IDENTIFICATION |
25e04747 | 539 | The definition starts with the string |
b8a2e38e | 540 | .I LC_IDENTIFICATION |
25e04747 | 541 | in the first column. |
2dad4c59 | 542 | .PP |
25e04747 MK |
543 | The following keywords are allowed: |
544 | .TP | |
545 | .I title | |
5f7504ef | 546 | followed by the title of the locale document |
25e04747 MK |
547 | (e.g., "Maori language locale for New Zealand"). |
548 | .TP | |
549 | .I source | |
550 | followed by the name of the organization that maintains this document. | |
551 | .TP | |
552 | .I address | |
553 | followed by the address of the organization that maintains this document. | |
554 | .TP | |
555 | .I contact | |
556 | followed by the name of the contact person at | |
557 | the organization that maintains this document. | |
558 | .TP | |
559 | .I email | |
e9f22b0a | 560 | followed by the email address of the person or |
25e04747 MK |
561 | organization that maintains this document. |
562 | .TP | |
563 | .I tel | |
564 | followed by the telephone number (in international format) | |
565 | of the organization that maintains this document. | |
e27900b2 MM |
566 | As of glibc 2.24, this keyword is deprecated in favor of |
567 | other contact methods. | |
25e04747 MK |
568 | .TP |
569 | .I fax | |
5f7504ef | 570 | followed by the fax number (in international format) |
25e04747 | 571 | of the organization that maintains this document. |
e27900b2 MM |
572 | As of glibc 2.24, this keyword is deprecated in favor of |
573 | other contact methods. | |
25e04747 MK |
574 | .TP |
575 | .I language | |
576 | followed by the name of the language to which this document applies. | |
577 | .TP | |
578 | .I territory | |
579 | followed by the name of the country/geographic extent | |
580 | to which this document applies. | |
581 | .TP | |
582 | .I audience | |
74e03e90 MM |
583 | followed by a description of the audience for which this document is |
584 | intended. | |
25e04747 MK |
585 | .TP |
586 | .I application | |
587 | followed by a description of any special application | |
588 | for which this document is intended. | |
589 | .TP | |
590 | .I abbreviation | |
565a3ba9 | 591 | followed by the short name for provider of the source of this document. |
25e04747 MK |
592 | .TP |
593 | .I revision | |
594 | followed by the revision number of this document. | |
595 | .TP | |
596 | .I date | |
597 | followed by the revision date of this document. | |
598 | .PP | |
599 | In addition, for each of the categories defined by the document, | |
600 | there should be a line starting with the keyword | |
601 | .IR category , | |
602 | followed by: | |
22356d97 | 603 | .IP (1) 5 |
25e04747 | 604 | a string that identifies this locale category definition, |
22356d97 | 605 | .IP (2) |
25e04747 | 606 | a semicolon, and |
22356d97 | 607 | .IP (3) |
25e04747 | 608 | one of the |
14d43d30 | 609 | .B LC_* |
25e04747 MK |
610 | identifiers. |
611 | .PP | |
612 | The | |
613 | .B LC_IDENTIFICATION | |
614 | definition ends with the string | |
615 | .IR "END LC_IDENTIFICATION" . | |
8ed1a976 MK |
616 | .SS LC_MESSAGES |
617 | The definition starts with the string | |
b8a2e38e | 618 | .I LC_MESSAGES |
8ed1a976 | 619 | in the first column. |
2dad4c59 | 620 | .PP |
8ed1a976 MK |
621 | The following keywords are allowed: |
622 | .TP | |
623 | .I yesexpr | |
624 | followed by a regular expression that describes possible | |
625 | yes-responses. | |
626 | .TP | |
627 | .I noexpr | |
628 | followed by a regular expression that describes possible | |
629 | no-responses. | |
12320325 MK |
630 | .TP |
631 | .I yesstr | |
632 | followed by the output string corresponding to "yes". | |
633 | .TP | |
634 | .I nostr | |
635 | followed by the output string corresponding to "no". | |
8ed1a976 MK |
636 | .PP |
637 | The | |
638 | .B LC_MESSAGES | |
639 | definition ends with the string | |
640 | .IR "END LC_MESSAGES" . | |
586370d8 MK |
641 | .SS LC_MEASUREMENT |
642 | The definition starts with the string | |
b8a2e38e | 643 | .I LC_MEASUREMENT |
586370d8 | 644 | in the first column. |
2dad4c59 | 645 | .PP |
586370d8 MK |
646 | The following keywords are allowed: |
647 | .TP | |
648 | .I measurement | |
5f7504ef | 649 | followed by number identifying the standard used for measurement. |
586370d8 MK |
650 | The following values are recognized: |
651 | .RS | |
6aeda2ec | 652 | .TP 4 |
586370d8 MK |
653 | .B 1 |
654 | Metric. | |
655 | .TP | |
656 | .B 2 | |
657 | US customary measurements. | |
658 | .RE | |
659 | .PP | |
660 | The | |
661 | .B LC_MEASUREMENT | |
662 | definition ends with the string | |
663 | .IR "END LC_MEASUREMENT" . | |
fea681da MK |
664 | .SS LC_MONETARY |
665 | The definition starts with the string | |
b8a2e38e | 666 | .I LC_MONETARY |
fea681da | 667 | in the first column. |
2dad4c59 | 668 | .PP |
ce48c070 | 669 | The following keywords are allowed: |
fea681da MK |
670 | .TP |
671 | .I int_curr_symbol | |
c13182ef MK |
672 | followed by the international currency symbol. |
673 | This must be a | |
fea681da MK |
674 | 4-character string containing the international currency symbol as |
675 | defined by the ISO 4217 standard (three characters) followed by a | |
676 | separator. | |
677 | .TP | |
678 | .I currency_symbol | |
679 | followed by the local currency symbol. | |
680 | .TP | |
681 | .I mon_decimal_point | |
870d4881 FW |
682 | followed by the single-character string that will be used as the |
683 | decimal delimiter when formatting monetary quantities. | |
fea681da MK |
684 | .TP |
685 | .I mon_thousands_sep | |
870d4881 FW |
686 | followed by the single-character string that will be used as a group |
687 | separator when formatting monetary quantities. | |
fea681da MK |
688 | .TP |
689 | .I mon_grouping | |
6699fab5 | 690 | followed by a sequence of integers separated by semicolons that |
244b504c MK |
691 | describe the formatting of monetary quantities. |
692 | See | |
6699fab5 MM |
693 | .I grouping |
694 | below for details. | |
fea681da MK |
695 | .TP |
696 | .I positive_sign | |
697 | followed by a string that is used to indicate a positive sign for | |
698 | monetary quantities. | |
699 | .TP | |
700 | .I negative_sign | |
701 | followed by a string that is used to indicate a negative sign for | |
702 | monetary quantities. | |
703 | .TP | |
704 | .I int_frac_digits | |
705 | followed by the number of fractional digits that should be used when | |
c13182ef | 706 | formatting with the |
aef9ea90 | 707 | .IR int_curr_symbol . |
fea681da MK |
708 | .TP |
709 | .I frac_digits | |
710 | followed by the number of fractional digits that should be used when | |
c13182ef | 711 | formatting with the |
aef9ea90 | 712 | .IR currency_symbol . |
fea681da MK |
713 | .TP |
714 | .I p_cs_precedes | |
8afc6598 | 715 | followed by an integer that indicates the placement of |
fea681da | 716 | .I currency_symbol |
8afc6598 MK |
717 | for a nonnegative formatted monetary quantity: |
718 | .RS | |
6aeda2ec | 719 | .TP 4 |
fea681da | 720 | .B 0 |
8afc6598 MK |
721 | the symbol succeeds the value. |
722 | .TP | |
723 | .B 1 | |
724 | the symbol precedes the value. | |
725 | .RE | |
726 | .TP | |
fea681da | 727 | .I p_sep_by_space |
df31d6a5 MK |
728 | followed by an integer that indicates the separation of |
729 | .IR currency_symbol , | |
730 | the sign string, and the value for a nonnegative formatted monetary quantity. | |
731 | The following values are recognized: | |
fea681da | 732 | .RS |
6aeda2ec | 733 | .TP 4 |
fea681da | 734 | .B 0 |
df31d6a5 | 735 | No space separates the currency symbol and the value. |
fea681da MK |
736 | .TP |
737 | .B 1 | |
df31d6a5 MK |
738 | If the currency symbol and the sign string are adjacent, |
739 | a space separates them from the value; | |
740 | otherwise a space separates the currency symbol and the value. | |
fea681da | 741 | .TP |
c13182ef | 742 | .B 2 |
df31d6a5 MK |
743 | If the currency symbol and the sign string are adjacent, |
744 | a space separates them from the value; | |
745 | otherwise a space separates the sign string and the value. | |
fea681da MK |
746 | .RE |
747 | .TP | |
e4bcd971 MM |
748 | .I n_cs_precedes |
749 | followed by an integer that indicates the placement of | |
750 | .I currency_symbol | |
751 | for a negative formatted monetary quantity. | |
752 | The same values are recognized as for | |
753 | .IR p_cs_precedes . | |
754 | .TP | |
fea681da | 755 | .I n_sep_by_space |
d2a92628 MK |
756 | followed by an integer that indicates the separation of |
757 | .IR currency_symbol , | |
49b3d955 | 758 | the sign string, and the value for a negative formatted monetary quantity. |
d2a92628 MK |
759 | The same values are recognized as for |
760 | .IR p_sep_by_space . | |
fea681da MK |
761 | .TP |
762 | .I p_sign_posn | |
0a5c57f9 MK |
763 | followed by an integer that indicates where the |
764 | .I positive_sign | |
765 | should be placed for a nonnegative monetary quantity: | |
fea681da | 766 | .RS |
6aeda2ec | 767 | .TP 4 |
fea681da | 768 | .B 0 |
c13182ef | 769 | Parentheses enclose the quantity and the |
fea681da MK |
770 | .I currency_symbol |
771 | or | |
a5e0a0e4 | 772 | .IR int_curr_symbol . |
fea681da MK |
773 | .TP |
774 | .B 1 | |
775 | The sign string precedes the quantity and the | |
776 | .I currency_symbol | |
777 | or the | |
a5e0a0e4 | 778 | .IR int_curr_symbol . |
fea681da MK |
779 | .TP |
780 | .B 2 | |
781 | The sign string succeeds the quantity and the | |
782 | .I currency_symbol | |
783 | or the | |
a5e0a0e4 | 784 | .IR int_curr_symbol . |
fea681da MK |
785 | .TP |
786 | .B 3 | |
787 | The sign string precedes the | |
788 | .I currency_symbol | |
789 | or the | |
a5e0a0e4 | 790 | .IR int_curr_symbol . |
fea681da MK |
791 | .TP |
792 | .B 4 | |
793 | The sign string succeeds the | |
794 | .I currency_symbol | |
795 | or the | |
a5e0a0e4 | 796 | .IR int_curr_symbol . |
fea681da MK |
797 | .RE |
798 | .TP | |
799 | .I n_sign_posn | |
0a5c57f9 MK |
800 | followed by an integer that indicates where the |
801 | .I negative_sign | |
802 | should be placed for a negative monetary quantity. | |
548fe9a5 MK |
803 | The same values are recognized as for |
804 | .IR p_sign_posn . | |
805 | .TP | |
e4bcd971 MM |
806 | .I int_p_cs_precedes |
807 | followed by an integer that indicates the placement of | |
74e03e90 | 808 | .I int_curr_symbol |
e4bcd971 MM |
809 | for a nonnegative internationally formatted monetary quantity. |
810 | The same values are recognized as for | |
811 | .IR p_cs_precedes . | |
812 | .TP | |
813 | .I int_n_cs_precedes | |
814 | followed by an integer that indicates the placement of | |
74e03e90 | 815 | .I int_curr_symbol |
e4bcd971 MM |
816 | for a negative internationally formatted monetary quantity. |
817 | The same values are recognized as for | |
818 | .IR p_cs_precedes . | |
819 | .TP | |
820 | .I int_p_sep_by_space | |
821 | followed by an integer that indicates the separation of | |
74e03e90 | 822 | .IR int_curr_symbol , |
e4bcd971 MM |
823 | the sign string, |
824 | and the value for a nonnegative internationally formatted monetary quantity. | |
825 | The same values are recognized as for | |
826 | .IR p_sep_by_space . | |
827 | .TP | |
828 | .I int_n_sep_by_space | |
829 | followed by an integer that indicates the separation of | |
74e03e90 | 830 | .IR int_curr_symbol , |
e4bcd971 MM |
831 | the sign string, |
832 | and the value for a negative internationally formatted monetary quantity. | |
833 | The same values are recognized as for | |
834 | .IR p_sep_by_space . | |
835 | .TP | |
548fe9a5 MK |
836 | .I int_p_sign_posn |
837 | followed by an integer that indicates where the | |
6ba56b5c | 838 | .I positive_sign |
548fe9a5 MK |
839 | should be placed for a nonnegative |
840 | internationally formatted monetary quantity. | |
841 | The same values are recognized as for | |
842 | .IR p_sign_posn . | |
843 | .TP | |
844 | .I int_n_sign_posn | |
845 | followed by an integer that indicates where the | |
846 | .I negative_sign | |
847 | should be placed for a negative | |
848 | internationally formatted monetary quantity. | |
849 | The same values are recognized as for | |
0a5c57f9 | 850 | .IR p_sign_posn . |
fea681da | 851 | .PP |
c13182ef | 852 | The |
fea681da | 853 | .B LC_MONETARY |
c13182ef | 854 | definition ends with the string |
74d32233 | 855 | .IR "END LC_MONETARY" . |
929e0bf7 MK |
856 | .SS LC_NAME |
857 | The definition starts with the string | |
b8a2e38e | 858 | .I LC_NAME |
929e0bf7 | 859 | in the first column. |
2dad4c59 | 860 | .PP |
c33a8494 | 861 | Various keywords are allowed, but only |
b100ab55 | 862 | .I name_fmt |
c33a8494 | 863 | is mandatory. |
ee2d3ed6 | 864 | Other keywords are needed only if there is common convention to |
c33a8494 MK |
865 | use the corresponding salutation in this locale. |
866 | The allowed keywords are as follows: | |
929e0bf7 MK |
867 | .TP |
868 | .I name_fmt | |
869 | followed by a string containing field descriptors that define | |
870 | the format used for names in the locale. | |
871 | The following field descriptors are recognized: | |
929e0bf7 | 872 | .RS |
6aeda2ec | 873 | .TP 4 |
929e0bf7 MK |
874 | %f |
875 | Family name(s). | |
876 | .TP | |
877 | %F | |
878 | Family names in uppercase. | |
879 | .TP | |
880 | %g | |
881 | First given name. | |
882 | .TP | |
883 | %G | |
884 | First given initial. | |
885 | .TP | |
886 | %l | |
887 | First given name with Latin letters. | |
888 | .TP | |
889 | %o | |
890 | Other shorter name. | |
891 | .TP | |
892 | %m | |
893 | Additional given name(s). | |
894 | .TP | |
895 | %M | |
896 | Initials for additional given name(s). | |
897 | .TP | |
898 | %p | |
899 | Profession. | |
900 | .TP | |
901 | %s | |
902 | Salutation, such as "Doctor". | |
903 | .TP | |
904 | %S | |
905 | Abbreviated salutation, such as "Mr." or "Dr.". | |
906 | .TP | |
907 | %d | |
908 | Salutation, using the FDCC-sets conventions. | |
909 | .\" 1 for the name_gen | |
910 | .\" In glibc 2.19, %d1 is used in only: | |
911 | .\" /home/mtk/ARCHIVE/GLIBC/glibc-2.19/localedata/locales/bem_ZM | |
912 | .\" /home/mtk/ARCHIVE/GLIBC/glibc-2.19/localedata/locales/zh_HK | |
913 | .\" In glibc 2.19, %d[2-5] appear to be not used at all | |
914 | .\" 2 for name_mr | |
915 | .\" 3 for name_mrs | |
916 | .\" 4 for name_miss | |
917 | .\" 5 for name_ms | |
918 | .TP | |
919 | %t | |
920 | If the preceding field descriptor resulted in an empty string, | |
921 | then the empty string, otherwise a space character. | |
922 | .RE | |
923 | .TP | |
924 | .I name_gen | |
925 | followed by the general salutation for any gender. | |
926 | .TP | |
927 | .I name_mr | |
928 | followed by the salutation for men. | |
929 | .TP | |
930 | .I name_mrs | |
931 | followed by the salutation for married women. | |
932 | .TP | |
933 | .I name_miss | |
934 | followed by the salutation for unmarried women. | |
935 | .TP | |
936 | .I name_ms | |
937 | followed by the salutation valid for all women. | |
938 | .PP | |
939 | The | |
940 | .B LC_NAME | |
941 | definition ends with the string | |
942 | .IR "END LC_NAME" . | |
fea681da MK |
943 | .SS LC_NUMERIC |
944 | The definition starts with the string | |
b8a2e38e | 945 | .I LC_NUMERIC |
fea681da | 946 | in the first column. |
2dad4c59 | 947 | .PP |
fea681da | 948 | The following keywords are allowed: |
fea681da MK |
949 | .TP |
950 | .I decimal_point | |
870d4881 FW |
951 | followed by the single-character string that will be used as the |
952 | decimal delimiter when formatting numeric quantities. | |
fea681da MK |
953 | .TP |
954 | .I thousands_sep | |
870d4881 FW |
955 | followed by the single-character string that will be used as a group |
956 | separator when formatting numeric quantities. | |
fea681da MK |
957 | .TP |
958 | .I grouping | |
a581f759 MM |
959 | followed by a sequence of integers separated by semicolons |
960 | that describe the formatting of numeric quantities. | |
244b504c MK |
961 | .IP |
962 | Each integer specifies the number of digits in a group. | |
963 | The first integer defines the size of the group immediately | |
964 | to the left of the decimal delimiter. | |
965 | Subsequent integers define succeeding groups to the | |
966 | left of the previous group. | |
967 | If the last integer is not \-1, then the size of the previous group | |
968 | (if any) is repeatedly used for the remainder of the digits. | |
969 | If the last integer is \-1, then no further grouping is performed. | |
fea681da | 970 | .PP |
c13182ef | 971 | The |
fea681da | 972 | .B LC_NUMERIC |
c13182ef | 973 | definition ends with the string |
74d32233 | 974 | .IR "END LC_NUMERIC" . |
54095c2c MK |
975 | .SS LC_PAPER |
976 | The definition starts with the string | |
b8a2e38e | 977 | .I LC_PAPER |
54095c2c | 978 | in the first column. |
2dad4c59 | 979 | .PP |
54095c2c MK |
980 | The following keywords are allowed: |
981 | .TP | |
982 | .I height | |
983 | followed by the height, in millimeters, of the standard paper format. | |
984 | .TP | |
985 | .I width | |
986 | followed by the width, in millimeters, of the standard paper format. | |
987 | .PP | |
988 | The | |
989 | .B LC_PAPER | |
990 | definition ends with the string | |
991 | .IR "END LC_PAPER" . | |
86c4fcad MK |
992 | .SS LC_TELEPHONE |
993 | The definition starts with the string | |
b8a2e38e | 994 | .I LC_TELEPHONE |
86c4fcad | 995 | in the first column. |
2dad4c59 | 996 | .PP |
86c4fcad MK |
997 | The following keywords are allowed: |
998 | .TP | |
999 | .I tel_int_fmt | |
1000 | followed by a string that contains field descriptors that identify | |
1001 | the format used to dial international numbers. | |
1002 | The following field descriptors are recognized: | |
86c4fcad | 1003 | .RS |
6aeda2ec | 1004 | .TP 4 |
86c4fcad | 1005 | %a |
5f7504ef | 1006 | Area code without nationwide prefix (the prefix is often "00"). |
86c4fcad MK |
1007 | .TP |
1008 | %A | |
1009 | Area code including nationwide prefix. | |
1010 | .TP | |
1011 | %l | |
1012 | Local number (within area code). | |
1013 | .TP | |
1014 | %e | |
1015 | Extension (to local number). | |
1016 | .TP | |
1017 | %c | |
1018 | Country code. | |
1019 | .TP | |
1020 | %C | |
5f7504ef | 1021 | Alternate carrier service code used for dialing abroad. |
86c4fcad MK |
1022 | .TP |
1023 | %t | |
1024 | If the preceding field descriptor resulted in an empty string, | |
1025 | then the empty string, otherwise a space character. | |
1026 | .RE | |
1027 | .TP | |
1028 | .I tel_dom_fmt | |
1029 | followed by a string that contains field descriptors that identify | |
1030 | the format used to dial domestic numbers. | |
5f7504ef | 1031 | The recognized field descriptors are the same as for |
86c4fcad MK |
1032 | .IR tel_int_fmt . |
1033 | .TP | |
1034 | .I int_select | |
1035 | followed by the prefix used to call international phone numbers. | |
1036 | .TP | |
1037 | .I int_prefix | |
1038 | followed by the prefix used from other countries to dial this country. | |
1039 | .PP | |
1040 | The | |
1041 | .B LC_TELEPHONE | |
1042 | definition ends with the string | |
1043 | .IR "END LC_TELEPHONE" . | |
fea681da MK |
1044 | .SS LC_TIME |
1045 | The definition starts with the string | |
b8a2e38e | 1046 | .I LC_TIME |
fea681da | 1047 | in the first column. |
2dad4c59 | 1048 | .PP |
fea681da | 1049 | The following keywords are allowed: |
fea681da MK |
1050 | .TP |
1051 | .I abday | |
b458e1bf | 1052 | followed by a list of abbreviated names of the days of the week. |
33af8501 MK |
1053 | The list starts with the first day of the week |
1054 | as specified by | |
1055 | .I week | |
ee565781 MK |
1056 | (Sunday by default). |
1057 | See NOTES. | |
fea681da MK |
1058 | .TP |
1059 | .I day | |
b458e1bf | 1060 | followed by a list of names of the days of the week. |
33af8501 MK |
1061 | The list starts with the first day of the week |
1062 | as specified by | |
1063 | .I week | |
ee565781 MK |
1064 | (Sunday by default). |
1065 | See NOTES. | |
fea681da MK |
1066 | .TP |
1067 | .I abmon | |
1068 | followed by a list of abbreviated month names. | |
1069 | .TP | |
1070 | .I mon | |
1071 | followed by a list of month names. | |
1072 | .TP | |
fea681da | 1073 | .I d_t_fmt |
ea7208a6 MM |
1074 | followed by the appropriate date and time format |
1075 | (for syntax, see | |
4839256a | 1076 | .BR strftime (3)). |
fea681da MK |
1077 | .TP |
1078 | .I d_fmt | |
ea7208a6 MM |
1079 | followed by the appropriate date format |
1080 | (for syntax, see | |
4839256a | 1081 | .BR strftime (3)). |
fea681da MK |
1082 | .TP |
1083 | .I t_fmt | |
ea7208a6 MM |
1084 | followed by the appropriate time format |
1085 | (for syntax, see | |
4839256a | 1086 | .BR strftime (3)). |
fea681da | 1087 | .TP |
e4bcd971 MM |
1088 | .I am_pm |
1089 | followed by the appropriate representation of the | |
1090 | .B am | |
1091 | and | |
1092 | .B pm | |
1093 | strings. | |
1094 | This should be left empty for locales not using AM/PM convention. | |
1095 | .TP | |
fea681da | 1096 | .I t_fmt_ampm |
ea7208a6 MM |
1097 | followed by the appropriate time format |
1098 | (for syntax, see | |
4839256a | 1099 | .BR strftime (3)) |
ea7208a6 | 1100 | when using 12h clock format. |
0c2dbad1 | 1101 | This should be left empty for locales not using AM/PM convention. |
33af8501 | 1102 | .TP |
5ca8b4fa MM |
1103 | .I era |
1104 | followed by semicolon-separated strings that define how years are | |
1105 | counted and displayed for each era in the locale. | |
1106 | Each string has the following format: | |
1107 | .RS | |
1108 | .PP | |
1109 | .IR direction ":" offset ":" start_date ":" end_date ":" era_name ":" era_format | |
1110 | .PP | |
1111 | The fields are to be defined as follows: | |
5ca8b4fa MM |
1112 | .TP 4 |
1113 | .I direction | |
1114 | Either | |
b100ab55 | 1115 | .B + |
5ca8b4fa | 1116 | or |
b100ab55 BIG |
1117 | .BR \- . |
1118 | .B + | |
5ca8b4fa | 1119 | means the years closer to |
b100ab55 | 1120 | .I start_date |
5ca8b4fa MM |
1121 | have lower numbers than years closer to |
1122 | .IR end_date . | |
b100ab55 | 1123 | .B \- |
5ca8b4fa MM |
1124 | means the opposite. |
1125 | .TP | |
1126 | .I offset | |
1127 | The number of the year closest to | |
b100ab55 | 1128 | .I start_date |
5ca8b4fa | 1129 | in the era, corresponding to the |
b100ab55 | 1130 | .I %Ey |
5ca8b4fa MM |
1131 | descriptor (see |
1132 | .BR strptime (3)). | |
1133 | .TP | |
1134 | .I start_date | |
1135 | The start of the era in the form of | |
1136 | .IR yyyy/mm/dd . | |
1137 | Years prior AD 1 are represented as negative numbers. | |
1138 | .TP | |
1139 | .I end_date | |
1140 | The end of the era in the form of | |
1141 | .IR yyyy/mm/dd , | |
1142 | or one of the two special values of | |
b100ab55 | 1143 | .B \-* |
5ca8b4fa MM |
1144 | or |
1145 | .BR +* . | |
b100ab55 | 1146 | .B \-* |
5ca8b4fa | 1147 | means the ending date is the beginning of time. |
b100ab55 | 1148 | .B +* |
5ca8b4fa MM |
1149 | means the ending date is the end of time. |
1150 | .TP | |
1151 | .I era_name | |
1152 | The name of the era corresponding to the | |
8cc4d071 | 1153 | .I %EC |
5ca8b4fa MM |
1154 | descriptor (see |
1155 | .BR strptime (3)). | |
1156 | .TP | |
1157 | .I era_format | |
1158 | The format of the year in the era corresponding to the | |
1159 | .I %EY | |
1160 | descriptor (see | |
1161 | .BR strptime (3)). | |
1162 | .RE | |
1163 | .TP | |
1164 | .I era_d_fmt | |
1165 | followed by the format of the date in alternative era notation, | |
1166 | corresponding to the | |
1167 | .I %Ex | |
1168 | descriptor (see | |
1169 | .BR strptime (3)). | |
1170 | .TP | |
1171 | .I era_t_fmt | |
1172 | followed by the format of the time in alternative era notation, | |
1173 | corresponding to the | |
1174 | .I %EX | |
1175 | descriptor (see | |
1176 | .BR strptime (3)). | |
1177 | .TP | |
1178 | .I era_d_t_fmt | |
1179 | followed by the format of the date and time in alternative era notation, | |
1180 | corresponding to the | |
1181 | .I %Ec | |
1182 | descriptor (see | |
1183 | .BR strptime (3)). | |
1184 | .TP | |
e4bcd971 MM |
1185 | .I alt_digits |
1186 | followed by the alternative digits used for date and time in the locale. | |
1187 | .TP | |
33af8501 | 1188 | .I week |
a581f759 | 1189 | followed by a list of three values separated by semicolons: |
33af8501 MK |
1190 | The number of days in a week (by default 7), |
1191 | a date of beginning of the week (by default corresponds to Sunday), | |
1192 | and the minimal length of the first week in year (by default 4). | |
1193 | Regarding the start of the week, | |
1194 | .B 19971130 | |
1195 | shall be used for Sunday and | |
1196 | .B 19971201 | |
67da5267 | 1197 | shall be used for Monday. |
756f4b97 | 1198 | See NOTES. |
33af8501 MK |
1199 | .TP |
1200 | .IR first_weekday " (since glibc 2.2)" | |
fb51288c | 1201 | followed by the number of the day from the |
33af8501 | 1202 | .I day |
fb51288c | 1203 | list to be shown as the first day of the week in calendar applications. |
33af8501 MK |
1204 | The default value of |
1205 | .B 1 | |
a581f759 | 1206 | corresponds to either Sunday or Monday depending |
33af8501 MK |
1207 | on the value of the second |
1208 | .I week | |
ee565781 MK |
1209 | list item. |
1210 | See NOTES. | |
33af8501 MK |
1211 | .TP |
1212 | .IR first_workday " (since glibc 2.2)" | |
2f41dcab | 1213 | followed by the number of the first working day from the |
33af8501 MK |
1214 | .I day |
1215 | list. | |
71ad8cf0 | 1216 | The default value is |
a581f759 | 1217 | .BR 2 . |
756f4b97 | 1218 | See NOTES. |
d96eca4d MK |
1219 | .TP |
1220 | .I cal_direction | |
a581f759 | 1221 | followed by a number value that indicates the direction for the |
d96eca4d MK |
1222 | display of calendar dates, as follows: |
1223 | .RS | |
6aeda2ec | 1224 | .TP 4 |
5f7504ef DP |
1225 | .B 1 |
1226 | Left-right from top. | |
d96eca4d | 1227 | .TP |
5f7504ef DP |
1228 | .B 2 |
1229 | Top-down from left. | |
d96eca4d | 1230 | .TP |
5f7504ef DP |
1231 | .B 3 |
1232 | Right-left from top. | |
d96eca4d MK |
1233 | .RE |
1234 | .TP | |
1235 | .I date_fmt | |
d96eca4d | 1236 | followed by the appropriate date representation for |
ea7208a6 MM |
1237 | .BR date (1) |
1238 | (for syntax, see | |
4839256a | 1239 | .BR strftime (3)). |
fea681da | 1240 | .PP |
c13182ef | 1241 | The |
fea681da | 1242 | .B LC_TIME |
c13182ef | 1243 | definition ends with the string |
74d32233 | 1244 | .IR "END LC_TIME" . |
fea681da | 1245 | .SH FILES |
11faa348 | 1246 | .TP |
b49c2acb | 1247 | .I /usr/lib/locale/locale\-archive |
11faa348 MM |
1248 | Usual default locale archive location. |
1249 | .TP | |
1250 | .I /usr/share/i18n/locales | |
1251 | Usual default path for locale definition files. | |
3113c7f3 | 1252 | .SH STANDARDS |
bf56400c | 1253 | POSIX.2. |
756f4b97 MM |
1254 | .SH NOTES |
1255 | The collective GNU C library community wisdom regarding | |
95c24117 | 1256 | .IR abday , |
756f4b97 MM |
1257 | .IR day , |
1258 | .IR week , | |
95c24117 | 1259 | .IR first_weekday , |
756f4b97 | 1260 | and |
95c24117 | 1261 | .I first_workday |
756f4b97 MM |
1262 | states at |
1263 | https://sourceware.org/glibc/wiki/Locales | |
1264 | the following: | |
cdede5cd | 1265 | .IP \[bu] 3 |
756f4b97 MM |
1266 | The value of the second |
1267 | .I week | |
1268 | list item specifies the base of the | |
95c24117 MM |
1269 | .I abday |
1270 | and | |
756f4b97 | 1271 | .I day |
95c24117 | 1272 | lists. |
cdede5cd | 1273 | .IP \[bu] |
756f4b97 MM |
1274 | .I first_weekday |
1275 | specifies the offset of the first day-of-week in the | |
95c24117 MM |
1276 | .I abday |
1277 | and | |
756f4b97 | 1278 | .I day |
95c24117 | 1279 | lists. |
cdede5cd | 1280 | .IP \[bu] |
756f4b97 MM |
1281 | For compatibility reasons, all glibc locales should set the value of the |
1282 | second | |
1283 | .I week | |
1284 | list item to | |
1285 | .B 19971130 | |
1286 | (Sunday) and base the | |
95c24117 MM |
1287 | .I abday |
1288 | and | |
756f4b97 | 1289 | .I day |
95c24117 | 1290 | lists appropriately, and set |
756f4b97 | 1291 | .I first_weekday |
f809007b MM |
1292 | and |
1293 | .I first_workday | |
756f4b97 MM |
1294 | to |
1295 | .B 1 | |
1296 | or | |
1297 | .BR 2 , | |
f809007b MM |
1298 | depending on whether the week and work week actually starts on Sunday or |
1299 | Monday for the locale. | |
fea681da MK |
1300 | .\" .SH AUTHOR |
1301 | .\" Jochen Hein (Hein@Student.TU-Clausthal.de) | |
47297adb | 1302 | .SH SEE ALSO |
3dc4e840 | 1303 | .BR iconv (1), |
fea681da MK |
1304 | .BR locale (1), |
1305 | .BR localedef (1), | |
1306 | .BR localeconv (3), | |
b4bde2e0 | 1307 | .BR newlocale (3), |
fea681da | 1308 | .BR setlocale (3), |
ea7208a6 | 1309 | .BR strftime (3), |
5ca8b4fa | 1310 | .BR strptime (3), |
b4bde2e0 | 1311 | .BR uselocale (3), |
aa99bf8a | 1312 | .BR charmap (5), |
0c2dbad1 MM |
1313 | .BR charsets (7), |
1314 | .BR locale (7), | |
1315 | .BR unicode (7), | |
28a4c58c | 1316 | .BR utf\-8 (7) |