NAME

colldef − convert collation sequence source definition

SYNOPSIS

/usr/etc/colldef filename

DESCRIPTION

colldef converts a collation sequence source definition into a format usable by the strxfrm() and strcoll(3) functions.  It is used to define the many ways in which strings can be ordered and collated. 

colldef reads the collation sequence source definition from the standard input and stores the converted definition in filename.

The collation sequence definition specifies a set of collating elements and the rules defining how strings containing these should be ordered.  This is most useful for different language definitions.  The rules provide the following capabilities:

1-to-Many mapping
A single character is mapped into a string of collating elements.

Many-to-1 mapping
A string of two or more characters is mapped as a single collating element.

Null string mapping
A character, or string of characters, is mapped to a null collating element (that is, will be ignored).

Equivalence class definition. 
A collection of characters that have the same value.

Secondary ordering within equivalence class. 

USAGE

The following keywords may be used in the input file filename. 

charmap
Optional keyword. Defines where a mapping of the character and collating element symbols to the actual character encoding can be found.

substitute
Optional keyword. Defines a one-to-many mapping between a single byte and a character string.

order Mandatory keyword.  Defines the primary and secondary ordering of collating elements within this collation table. 

EXIT STATUS

colldef exits with the following values:

0 No errors were found and the output was successfully created. 

>0 Errors were found. 

FILES

/etc/locale/LC_COLLATE/locale/domain
standard private location for collation orders under the locale locale

/usr/share/lib/locale/LC_COLLATE
standard shared location for collation orders under the locale locale

SEE ALSO

strcoll(3)

System Services Overview

Sun Release 4.1  —  Last change: 2 February 1990