The charmap file starts with a header, that may consist of the following keywords:
is followed by the name of the codeset.
is followed by the max number of bytes for a multibyte-character. Multibyte characters are currently not supported. The default value is 1.
is followed by the min number of bytes for a character. This value must be less or equal than mb_cur_max. If not specified, it defaults to mb_cur_max.
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 ( \ ).
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 ( # ).
The charmap-definition itself starts with the keyword CHARMAP in column 1.
The following lines may have one of the two following forms to define the character-encodings:
This for defines exactly one character and its encoding.
This form defines a couple of characters. This is only useful for mutlibyte-characters, which are currently not implemented.
The encoding may be in each of the following three forms:
with a decimal number
with a hexadecimal number