.\" Hey emacs, this is -*- nroff -*- .\" .\" This file is part of locale(1) which displays the settings of the .\" 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., 675 Mass Ave, Cambridge, MA 02139, USA. .\" .TH charmap 5 "28 Nov 1994" "National Language Support" "Linux User Manual" .SH NAME charmap \- character symbols to define character encodings .SH DESCRIPTION A character set description (charmap) defines a characterset of available characters and their encodings. All supported character sets should have the .B portable character set as a proper subset. The portable character set is defined in the file .I /usr/lib/nls/charmap/POSIX for reference purposes. .SH SYNTAX The charmap file starts with a header, that may consist of the following keywords: .TP .I is followed by the name of the codeset. .TP .I is followed by the max number of bytes for a multibyte-character. Multibyte characters are currently not supported. The default value is 1. .TP .I is followed by the min number of bytes for a character. This value must be less or equal than .B mb_cur_max. If not specified, it defaults to .B mb_cur_max. .TP .I 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 ( .B \\\\ ). .TP .I 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 ( .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 This for defines exactly one character and its encoding. .TP .I ... This form defines a couple of characters. This is only useful for mutlibyte-characters, which are currently not implemented. .PP The last line in a charmap-definition file must contain .B END CHARMAP. .SH SYMBOLIC NAMES A .B symbolic name for a character contains only characters of the .B portable character set. The name itself isenclosed between angle brackets. Characters following the .B are interpreted as itself; for example, the sequence .B '<\\\\\\\\\\\\>>' represents the symbolic name .B '\\\\>' enclosed in angle brackets. .SH CHARACTER ENCODING The encoding may be in each of the following three forms: .TP .I d with a decimal number .TP .I x with a hexadecimal number .TP .I with an octal number. .\" XXX - comments .\" XXX - char ... char .SH FILES .I /usr/lib/nls/charmap/* .SH AUTHOR Jochen Hein (jochen.hein@delphi.central.de) .SH CONFORMING TO POSIX.2 .SH SEE ALSO .BR setlocale (3), .BR localeconv (3), .BR locale (1), .BR locale (5), .BR localedef (1),