man5/repertoiremap.5

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