| 1 |
.\" Copyright, the authors of the Linux man-pages project |
| 2 |
.\" |
| 3 |
.\" SPDX-License-Identifier: GPL-2.0-or-later |
| 4 |
.\" |
| 5 |
.TH repertoiremap 5 2025-05-17 "Linux man-pages 6.18" |
| 6 |
.SH NAME |
| 7 |
repertoiremap \- map symbolic character names to Unicode code points |
| 8 |
.SH DESCRIPTION |
| 9 |
A repertoire map defines mappings between symbolic character names |
| 10 |
(mnemonics) and Unicode code points when compiling a locale with |
| 11 |
.BR localedef (1). |
| 12 |
Using a repertoire map is optional, it is needed only when symbolic |
| 13 |
names are used instead of now preferred Unicode code points. |
| 14 |
.SS Syntax |
| 15 |
The repertoiremap file starts with a header that may consist of the |
| 16 |
following keywords: |
| 17 |
.TP |
| 18 |
.I comment_char |
| 19 |
is followed by a character that will be used as the |
| 20 |
comment character for the rest of the file. |
| 21 |
It defaults to the number sign (#). |
| 22 |
.TP |
| 23 |
.I escape_char |
| 24 |
is followed by a character that should be used as the escape character |
| 25 |
for the rest of the file to mark characters that should be interpreted |
| 26 |
in a special way. |
| 27 |
It defaults to the backslash (\[rs]). |
| 28 |
.P |
| 29 |
The mapping section starts with the keyword |
| 30 |
.I CHARIDS |
| 31 |
in the first column. |
| 32 |
.P |
| 33 |
The mapping lines have the following form: |
| 34 |
.TP |
| 35 |
.I <symbolic-name> <code-point> comment |
| 36 |
This defines exactly one mapping, |
| 37 |
.I comment |
| 38 |
being optional. |
| 39 |
.P |
| 40 |
The mapping section ends with the string |
| 41 |
.IR "END CHARIDS" . |
| 42 |
.SH FILES |
| 43 |
.TP |
| 44 |
.I /usr/share/i18n/repertoiremaps |
| 45 |
Usual default repertoire map path. |
| 46 |
.SH STANDARDS |
| 47 |
POSIX.2. |
| 48 |
.SH NOTES |
| 49 |
Repertoire maps are deprecated in favor of Unicode code points. |
| 50 |
.SH EXAMPLES |
| 51 |
A mnemonic for the Euro sign can be defined as follows: |
| 52 |
.P |
| 53 |
.nf |
| 54 |
<Eu> <U20AC> EURO SIGN |
| 55 |
.fi |
| 56 |
.SH SEE ALSO |
| 57 |
.BR locale (1), |
| 58 |
.BR localedef (1), |
| 59 |
.BR charmap (5), |
| 60 |
.BR locale (5) |