man-pages/man5/charmap.5.html
2021-03-31 01:06:50 +01:00

202 lines
4.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of CHARMAP</TITLE>
</HEAD><BODY>
<H1>CHARMAP</H1>
Section: Linux Programmer's Manual (5)<BR>Updated: 2019-03-06<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
charmap - character set description file
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
A character set description (charmap) defines all available characters
and their encodings in a character set.
<B><A HREF="/cgi-bin/man/man2html?1+localedef">localedef</A></B>(1)
can use charmaps to create locale variants for different character sets.
<A NAME="lbAD">&nbsp;</A>
<H3>Syntax</H3>
The charmap file starts with a header that may consist of the
following keywords:
<DL COMPACT>
<DT id="1">&lt;<I>code_set_name</I>&gt;
<DD>
is followed by the name of the character map.
<DT id="2">&lt;<I>comment_char</I>&gt;
<DD>
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 (#).
<DT id="3">&lt;<I>escape_char</I>&gt;
<DD>
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 (\).
<DT id="4">&lt;<I>mb_cur_max</I>&gt;
<DD>
is followed by the maximum number of bytes for a character.
The default value is 1.
<DT id="5">&lt;<I>mb_cur_min</I>&gt;
<DD>
is followed by the minimum number of bytes for a character.
This value must be less than or equal than
&lt;<I>mb_cur_max</I>&gt;.
If not specified, it defaults to
&lt;<I>mb_cur_max</I>&gt;.
</DL>
<P>
The character set definition section starts with the keyword
<I>CHARMAP</I>
in the first column.
<P>
The following lines may have one of the two following forms to
define the character set:
<DL COMPACT>
<DT id="6">&lt;<I>character</I>&gt;&nbsp;<I>byte-sequence&nbsp;comment</I>
<DD>
This form defines exactly one character and its byte sequence,
<I>comment</I>
being optional.
<DT id="7">&lt;<I>character</I>&gt;..&lt;<I>character</I>&gt;&nbsp;<I>byte-sequence&nbsp;comment</I>
<DD>
This form defines a character range and its byte sequence,
<I>comment</I>
being optional.
</DL>
<P>
The character set definition section ends with the string
<I>END CHARMAP</I>.
<P>
The character set definition section may optionally be followed by a
section to define widths of characters.
<P>
The
<I>WIDTH_DEFAULT</I>
keyword can be used to define the default width for all characters
not explicitly listed.
The default character width is 1.
<P>
The width section for individual characters starts with the keyword
<I>WIDTH</I>
in the first column.
<P>
The following lines may have one of the two following forms to
define the widths of the characters:
<DL COMPACT>
<DT id="8">&lt;<I>character</I>&gt;&nbsp;<I>width</I>
<DD>
This form defines the width of exactly one character.
<DT id="9">&lt;<I>character</I>&gt;...&lt;<I>character</I>&gt;&nbsp;<I>width</I>
<DD>
This form defines the width for all the characters in the range.
</DL>
<P>
The width definition section ends with the string
<I>END WIDTH</I>.
<A NAME="lbAE">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="10"><I>/usr/share/i18n/charmaps</I>
<DD>
Usual default character map path.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>CONFORMING TO</H2>
POSIX.2.
<A NAME="lbAG">&nbsp;</A>
<H2>EXAMPLE</H2>
The Euro sign is defined as follows in the
<I>UTF-8</I>
charmap:
<P>
<PRE>
&lt;U20AC&gt; /xe2/x82/xac EURO SIGN
</PRE>
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?1+iconv">iconv</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+locale">locale</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?1+localedef">localedef</A></B>(1),
<B><A HREF="/cgi-bin/man/man2html?5+locale">locale</A></B>(5),
<B><A HREF="/cgi-bin/man/man2html?7+charsets">charsets</A></B>(7)
<A NAME="lbAI">&nbsp;</A>
<H2>COLOPHON</H2>
This page is part of release 5.05 of the Linux
<I>man-pages</I>
project.
A description of the project,
information about reporting bugs,
and the latest version of this page,
can be found at
<A HREF="https://www.kernel.org/doc/man-pages/.">https://www.kernel.org/doc/man-pages/.</A>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="11"><A HREF="#lbAB">NAME</A><DD>
<DT id="12"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DL>
<DT id="13"><A HREF="#lbAD">Syntax</A><DD>
</DL>
<DT id="14"><A HREF="#lbAE">FILES</A><DD>
<DT id="15"><A HREF="#lbAF">CONFORMING TO</A><DD>
<DT id="16"><A HREF="#lbAG">EXAMPLE</A><DD>
<DT id="17"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="18"><A HREF="#lbAI">COLOPHON</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:02 GMT, March 31, 2021
</BODY>
</HTML>