HP-UX Reference (11i v2 03/08) - 4 File Formats (vol 8)

c
charmap(4) charmap(4)
NAME
charmap - symbolic translation file for localedef scripts
SYNOPSIS
localedef -f charmap locale_name
DESCRIPTION
Invoking the localedef command with the -f
option causes symbolic names in the locale descrip-
tion file to be translated into the encodings given in the charmap file (see localedef (1M)). As a recom-
mendation, a locale description file should be written completely with symbolic names.
The charmap file has two sections: a declarations section and a character definition section.
Declarations Section
Declarations can precede the character definitions.
Each consists of the symbol (including the surrounding angle brackets), followed by one or more blanks
(or tabs or space characters), followed by the value of the symbol.
Certain declarations are required for multibyte character codesets. For single-byte codesets, all are
optional.
Following is a list of possible declarations:
<code_set_name> value
Used to declare the name of the coded character set for which the charmap file is defined. This key-
word is required for multibyte character codesets. For HP15 encoding scheme,
HP15 needs to be
part of the name. For EUC encoding scheme, EUC needs to be part of the name.
<cswidth> value
Used to declare the cswidth parameter of the coded character set for which the charmap file is
defined (see eucset (1)).
<mb_cur_max> value
Used to declare the maximum number of bytes in a multibyte character. Defaults to 1 if not given.
For multibyte character codesets, this keyword must be specified.
<mb_cur_min> value
Used to declare the minimum number of bytes in a character for the encoded character set. The
value must be less than or equal to
<mb_cur_max>. If not given, the default is equal to
<mb_cur_max>.
<escape_char> value
Used to declare the escape character, which is used to escape characters that otherwise would have
special meaning. If not given, the default is backslash (
\).
<comment_char> value
Used to declare the comment character, which is used to begin comments and should be placed in
column one of the charmap file. If not given, the default is the
# character.
Character Definition Section
The character-set mapping definitions immediately follow an identifier line containing the string
CHAR-
MAP and precede a trailer line consisting of the string END CHARMAP. (Empty lines and lines beginning
with the comment character are ignored.)
The character definitions are of two forms.
The first form defines a single character and its encoding:
<symbolic_name> encoding
A symbolic_name is one or more visible characters from the portable character set as specified by XPG,
enclosed in angle brackets. Metacharacters such as angle brackets, escape characters, or comment char-
acters must be escaped if they are used in the name. Two or more symbolic names can be given for the
same encoding.
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 4−−31