Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
charmap(4)		   Kernel Interfaces Manual		    charmap(4)

NAME
       charmap - symbolic translation file for localedef scripts

SYNOPSIS
       charmap

DESCRIPTION
       Invoking	 the  command with the option causes symbolic names in the lo-
       cale description	file to	be translated into the encodings given in  the
       charmap	file  (see  localedef(1M)).  As	a recommendation, a locale de-
       scription file should be	written	completely with	symbolic names.

       The charmap file	has two	sections: a declarations section and a charac-
       ter 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:

       value

	      Used to declare the name of the coded character  set  for	 which
	      the  charmap  file  is  defined.	 This  keyword is required for
	      multibyte	character codesets.  For HP15 encoding	scheme,	 needs
	      to  be  part  of the name.  For EUC encoding scheme, needs to be
	      part of the name.

       value

	      Used to declare the cswidth parameter of the coded character set
	      for which	the charmap file is defined (see eucset(1)).

       value

	      Used to declare the maximum number of bytes in a multibyte char-
	      acter.  Defaults to 1 if not  given.   For  multibyte  character
	      codesets,	this keyword must be specified.

       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 If not	given, the default is equal to

       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

       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 and precede a	trailer	line consisting	of the
       string  (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:

	      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
       characters  must	 be escaped if they are	used in	the name.  Two or more
       symbolic	names can be given for the same	encoding.

       The encoding is a character constant in one of three forms:

	      decimal	     An	escape character followed by the  letter  fol-
			     lowed by one to three decimal digits.

	      octal	     An	 escape	character followed by one to three oc-
			     tal digits.

	      hexadecimal    An	escape character followed by  an  followed  by
			     two hexadecimal digits.

       Multibyte  characters are represented by	the concatenation of character
       constants.  All constants used in the encoding of a multibyte character
       must be of the same form.

       The second form defines a range of characters consisting	of all charac-
       ters from the first symbolic name to the	second,	inclusive:

	      ...  encoding

       The symbolic name must consist of one  or  more	nonnumeric  characters
       followed	by an integer formed of	one or more decimal digits.  The inte-
       ger part	of the second symbolic name must be larger than	 that  of  the
       first.	The range is then interpreted as a list	of symbolic names con-
       sisting of the same character portion  and  successive  integer	values
       from  the  first	through	the last.  These names are assigned successive
       encodings starting with the one given.

       For example, the	character definition line

       is equivalent to:

EXAMPLES
       For examples, see any of	the files under	directory.

SEE ALSO
       localedef(1M), localedef(4).

STANDARDS COMPLIANCE
								    charmap(4)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | SEE ALSO | STANDARDS COMPLIANCE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=charmap&sektion=4&manpath=HP-UX+11.22>

home | help