2004-11-03 13:51:07 +00:00
|
|
|
.\" Hey emacs, this is -*- nroff -*-
|
|
|
|
.\"
|
2007-04-12 22:42:49 +00:00
|
|
|
.\" This file is part of locale(1) which displays the settings of the
|
2004-11-03 13:51:07 +00:00
|
|
|
.\" current locale.
|
|
|
|
.\" Copyright (C) 1994 Jochen Hein (Hein@Student.TU-Clausthal.de)
|
|
|
|
.\"
|
|
|
|
.\" This program is free software; you can redistribute it and/or modify
|
|
|
|
.\" it under the terms of the GNU General Public License as published by
|
|
|
|
.\" the Free Software Foundation; either version 2 of the License, or
|
|
|
|
.\" (at your option) any later version.
|
|
|
|
.\"
|
|
|
|
.\" This program is distributed in the hope that it will be useful,
|
|
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
.\" GNU General Public License for more details.
|
|
|
|
.\"
|
|
|
|
.\" You should have received a copy of the GNU General Public License
|
|
|
|
.\" along with this program; if not, write to the Free Software
|
|
|
|
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
|
|
|
|
.\"
|
2007-05-18 08:43:42 +00:00
|
|
|
.TH CHARMAP 5 1994-11-28 "" "Linux User Manual"
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH NAME
|
|
|
|
charmap \- character symbols to define character encodings
|
|
|
|
.SH DESCRIPTION
|
2005-06-24 14:17:21 +00:00
|
|
|
A character set description (charmap) defines a character set of
|
2007-04-12 22:42:49 +00:00
|
|
|
available characters and their encodings.
|
|
|
|
All supported character
|
|
|
|
sets should have the
|
2004-11-03 13:51:07 +00:00
|
|
|
.B portable character set
|
|
|
|
as a proper subset.
|
|
|
|
.\" Not true anymore:
|
|
|
|
.\" The portable character set is defined in the file
|
|
|
|
.\" .I /usr/lib/nls/charmap/POSIX
|
|
|
|
.\" .I /usr/share/i18n/charmap/POSIX
|
|
|
|
.\" for reference purposes.
|
2007-06-15 19:55:07 +00:00
|
|
|
.SS Syntax
|
2004-11-03 13:51:07 +00:00
|
|
|
The charmap file starts with a header, that may consist of the
|
|
|
|
following keywords:
|
|
|
|
.TP
|
|
|
|
.I <codeset>
|
|
|
|
is followed by the name of the codeset.
|
|
|
|
.TP
|
|
|
|
.I <mb_cur_max>
|
|
|
|
is followed by the max number of bytes for a multibyte-character.
|
2007-04-12 22:42:49 +00:00
|
|
|
Multibyte characters are currently not supported.
|
|
|
|
The default value
|
2004-11-03 13:51:07 +00:00
|
|
|
is 1.
|
|
|
|
.TP
|
|
|
|
.I <mb_cur_min>
|
2007-04-12 22:42:49 +00:00
|
|
|
is followed by the min number of bytes for a character.
|
|
|
|
This
|
|
|
|
value must be less or equal than
|
2005-07-19 15:36:19 +00:00
|
|
|
.BR mb_cur_max .
|
2004-11-03 13:51:07 +00:00
|
|
|
If not specified, it defaults to
|
2005-07-19 15:36:19 +00:00
|
|
|
.BR mb_cur_max .
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.I <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
|
2007-04-12 22:42:49 +00:00
|
|
|
should be interpreted in a special way.
|
|
|
|
It defaults to
|
2004-11-03 13:51:07 +00:00
|
|
|
the backslash (
|
2007-04-12 22:42:49 +00:00
|
|
|
.B \\\\
|
2004-11-03 13:51:07 +00:00
|
|
|
).
|
|
|
|
.TP
|
|
|
|
.I <comment_char>
|
|
|
|
is followed by a character that will be used as the
|
2007-04-12 22:42:49 +00:00
|
|
|
comment-character for the rest of the file.
|
|
|
|
It defaults to the
|
2004-11-03 13:51:07 +00:00
|
|
|
number sign (
|
|
|
|
.B #
|
|
|
|
).
|
|
|
|
.PP
|
|
|
|
The charmap-definition itself starts with the keyword
|
|
|
|
.B CHARMAP
|
|
|
|
in column 1.
|
|
|
|
|
|
|
|
The following lines may have one of the two following forms to
|
|
|
|
define the character-encodings:
|
|
|
|
.TP
|
|
|
|
.I <symbolic-name> <encoding> <comments>
|
2007-04-12 22:42:49 +00:00
|
|
|
This form defines exactly one character and its encoding.
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.I <symbolic-name>...<symbolic-name> <encoding> <comments>
|
2007-04-12 22:42:49 +00:00
|
|
|
This form defines a couple of characters.
|
|
|
|
This is only useful for
|
2007-06-08 10:58:53 +00:00
|
|
|
multibyte-characters, which are currently not implemented.
|
2004-11-03 13:51:07 +00:00
|
|
|
.PP
|
|
|
|
The last line in a charmap-definition file must contain
|
|
|
|
.B END CHARMAP.
|
2007-06-15 19:55:07 +00:00
|
|
|
.SS "Symbolic Names"
|
2007-04-12 22:42:49 +00:00
|
|
|
A
|
2004-11-03 13:51:07 +00:00
|
|
|
.B symbolic name
|
2007-04-12 22:42:49 +00:00
|
|
|
for a character contains only characters of the
|
2004-11-03 13:51:07 +00:00
|
|
|
.B portable character set.
|
|
|
|
The name itself is enclosed between angle brackets.
|
|
|
|
Characters following an
|
2007-04-12 22:42:49 +00:00
|
|
|
.B <escape_char>
|
2004-11-03 13:51:07 +00:00
|
|
|
are interpreted as itself; for example, the sequence
|
|
|
|
.B '<\\\\\\\\\\\\>>'
|
|
|
|
represents the symbolic name
|
|
|
|
.B '\\\\>'
|
|
|
|
enclosed in angle brackets.
|
2007-06-15 19:55:07 +00:00
|
|
|
.SS "Character Encoding"
|
2004-11-03 13:51:07 +00:00
|
|
|
The
|
|
|
|
encoding may be in each of the following three forms:
|
|
|
|
.TP
|
|
|
|
.I <escape_char>d<number>
|
|
|
|
with a decimal number
|
|
|
|
.TP
|
|
|
|
.I <escape_char>x<number>
|
2007-04-12 22:42:49 +00:00
|
|
|
with a hexadecimal number
|
2004-11-03 13:51:07 +00:00
|
|
|
.TP
|
|
|
|
.I <escape_char><number>
|
|
|
|
with an octal number.
|
2006-03-23 02:13:08 +00:00
|
|
|
.\" FIXME comments
|
|
|
|
.\" FIXME char ... char
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH FILES
|
|
|
|
.I /usr/share/i18n/charmaps/*
|
2007-05-16 03:40:19 +00:00
|
|
|
.\" .SH AUTHOR
|
|
|
|
.\" Jochen Hein (jochen.hein@delphi.central.de)
|
2004-11-03 13:51:07 +00:00
|
|
|
.SH "CONFORMING TO"
|
|
|
|
POSIX.2
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR locale (1),
|
|
|
|
.BR localedef (1),
|
|
|
|
.BR localeconv (3),
|
|
|
|
.BR setlocale (3),
|
|
|
|
.BR locale (5)
|