]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man5/charmap.5
sock_diag.7: ffix: white space tweaks in example program
[thirdparty/man-pages.git] / man5 / charmap.5
index b9b2084b576ea09ba60ce61785c9087066bbe573..0cb8db738756ec1673dc3ac75051bd17a3574869 100644 (file)
 .\" <http://www.gnu.org/licenses/>.
 .\" %%%LICENSE_END
 .\"
-.TH CHARMAP 5 2014-06-02 "GNU" "Linux Programmer's Manual"
+.TH CHARMAP 5 2016-07-17 "GNU" "Linux Programmer's Manual"
 .SH NAME
-charmap \- characters to define character sets
+charmap \- character set description file
 .SH DESCRIPTION
 A character set description (charmap) defines all available characters
 and their encodings in a character set.
-All ISO C compliant character sets should have
-the ASCII character set as a proper subset.
+.BR localedef (1)
+can use charmaps to create locale variants for different character sets.
 .SS Syntax
 The charmap file starts with a header that may consist of the
 following keywords:
 .TP
-.I <code_set_name>
+.RI < code_set_name >
 is followed by the name of the character map.
 .TP
-.I <comment_char>
+.RI < comment_char >
 is followed by a character that will be used as the comment character
 for the rest of the file.
 It defaults to the number sign (#).
 .TP
-.I <escape_char>
+.RI < escape_char >
 is followed by a character that should be used as the escape character
 for the rest of the file to mark characters that should be interpreted
 in a special way.
 It defaults to the backslash (\\).
 .TP
-.I <mb_cur_max>
+.RI < mb_cur_max >
 is followed by the maximum number of bytes for a character.
 The default value is 1.
 .TP
-.I <mb_cur_min>
+.RI < mb_cur_min >
 is followed by the minimum number of bytes for a character.
 This value must be less than or equal than
-.IR mb_cur_max .
+.RI < mb_cur_max >.
 If not specified, it defaults to
-.IR mb_cur_max .
+.RI < mb_cur_max >.
 .PP
 The character set definition section starts with the keyword
-.B CHARMAP
+.I CHARMAP
 in the first column.
 
 The following lines may have one of the two following forms to
 define the character set:
 .TP
-.I <character> <byte-sequence> <comment>
+.RI < character >\  byte-sequence\ comment
 This form defines exactly one character and its byte sequence,
-.I <comment>
+.I comment
 being optional.
 .TP
-.I <character>..<character> <byte-sequence> <comment>
+.RI < character >..< character >\  byte-sequence\ comment
 This form defines a character range and its byte sequence,
-.I <comment>
+.I comment
 being optional.
 .PP
 The character set definition section ends with the string
@@ -76,17 +76,23 @@ The character set definition section ends with the string
 The character set definition section may optionally be followed by a
 section to define widths of characters.
 .PP
-The width section starts with the keyword
-.B WIDTH
+The
+.I WIDTH_DEFAULT
+keyword can be used to define the default width for all characters
+not explicitly listed.
+The default character width is 1.
+.PP
+The width section for individual characters starts with the keyword
+.I WIDTH
 in the first column.
 
 The following lines may have one of the two following forms to
 define the widths of the characters:
 .TP
-.I <character> <width>
+.RI < character >\  width
 This form defines the width of exactly one character.
 .TP
-.I <character>...<character> <width>
+.RI < character >...< character >\  width
 This form defines the width for all the characters in the range.
 .PP
 The width definition section ends with the string
@@ -103,7 +109,7 @@ The Euro sign is defined as follows in the
 charmap:
 .PP
 .nf
-<U20AC>     /xe2/x82/xac
+<U20AC>     /xe2/x82/xac EURO SIGN
 .fi
 .SH SEE ALSO
 .BR iconv (1),