genxlt(1)							     genxlt(1)

NAME
       genxlt - generate iconv translation tables

SYNOPSIS
       [output_filename] [input_filename]

DESCRIPTION
       generates  a  compiled,	non-readable binary version of the iconv table
       that is suitable for use by iconv(1) and iconv(3C).  If	input_filename
       or output_filename is not supplied, standard input and/or standard out‐
       put will be used.

       Since the output of is a binary, non-readable file, if  the  option  is
       not  used,  the	redirection symbol maybe used to redirect the standard
       output to a file.

   Options
       recognizes the following options:

	      If this option is not selected, the data will be sent  to	 stan‐
	      dard
			     output,  from  where  it could be redirected to a
			     file.

       creates tables that are in a prescribed format and which can be	inter‐
       preted by the default conversion routines of iconv(3C).	The input file
       has two columns, giving the filecode mapping between the two code sets.
       The entries are in hexadecimal.

       The  input file must be formatted as two columns of hexadecimal digits.
       Characters in the first column are translated into  the	characters  in
       the second column.  Lines preceded with in the first column are ignored
       as comments on all lines except in the case of the following  keywords:
       #Galley: and #What:

       In  addition  to the data, which defines the filecode mapping, a Galley
       character (see iconv(3C)) may also be defined for that particular  con‐
       version.	 This is done by adding the line to the beginning of the input
       file.  The  is  any  multi-byte	character  (see	 A  What  string  (see
       what(1)),  may  also  be defined in the input file using the entry This
       string may contain information like version number, type of conversion,
       etc.,  which are not used in any way for the conversions.  Note that if
       the What string is defined, it should appear before the Galley  defini‐
       tion.

EXTERNAL INFLUENCES
   Environment Variables
       provides	 a  default  value for the internationalization variables that
       are unset or null.  If is unset or null, the default value of "C"  (see
       lang(5))	 is  used.   If any of the internationalization variables con‐
       tains an invalid setting, will behave as	 if  all  internationalization
       variables are set to "C" (see environ(5)).

       If  is  set to a non-empty string value, it overrides the values of all
       the other internationalization variables.

       determines the locale that should be used to affect the format and con‐
       tents  of diagnostic messages written to standard error and informative
       messages written to standard output.

       determines the location of message catalogues for the processing of

   International Code Set Support
       Single and multi-byte character code sets are supported.

RETURN VALUE
       The exit values are:

	  Successful completion.
	  Error condition occurred.

EXAMPLES
       This example compiles the iconv_input and puts the output binary in The
       following  iconv	 statement  uses  the roma8=iso81 table to convert the
       data_file from code set to code set

       This is an example of the input_file:

WARNINGS
       Because will write over the existing table, it  is  wise	 to  save  the
       existing table into another file before using

       Warnings are not given for incorrect data in the input_file.

       You must have super-user privileges to install files in

FILES
       All tables must be installed in this directory.

SEE ALSO
       dmpxlt(1), iconv(1), iconv(3C).

STANDARDS COMPLIANCE
       tables

								     genxlt(1)

Vote for polarhome