ic(1) ic(1)
NAME
ic - compile an international database (internationalization compiler)
SYNOPSIS
ic [preprocessoroption ...] [option ...] [source]
DESCRIPTION
ic takes a database source file as input and generates from it inter-
mediate files which can be further processed by the system administra-
tor to produce databases that comply with the 5.4 format.
If the -VSINIX option is set, ic behaves as under SINIX versions V5.22
and V5.23 and generates a binary international NLS database from the
source file. ic reads the source text either from a file or from stan-
dard input. The output produced by ic is written to one or more files
(see the -o option).
ic uses the C preprocessor of the C-DS C development system.
Preprocessor options
preprocessoroption can be: -D, -U or -I.
These options are passed on to the C preprocessor.
-Dname[=def]
The value def is assigned to the symbolic constant name. This
option has the same effect as the preprocessor directive #define.
=def not specified: name is assigned a value of 1.
-Uname
Any initial definitions that assign a value to the symbolic con-
stant are removed. This option has the same effect as the prepro-
cessor directive #undef.
-Idir
The directory named dir is also searched for header files.
OPTIONS
No option specified:
ic generates a number of intermediate files and a shell script
which can be used by the system administrator to create a data-
base in 5.4 format.
-V5.4
This option is set by default. ic generates a number of files and
a shell script which enables the system administrator to create a
database in 5.4 format.
Page 1 Reliant UNIX 5.44 Printed 11/98
ic(1) ic(1)
-VSINIX
ic generates a binary NLS database in SINIX V5.2x format from the
source file.
-M modifier
Causes ic to use information defined by modifier when generating
the temporary files. modifier is the parameter which you set as
the @modifier element for the shell variable LANG.
The -VSINIX option may not be used in combination with either -V5.4 or
-M.
-v When the source file is successfully compiled, statistical infor-
mation is output to standard error indicating:
- the number of simple and multi-byte characters
- the number and type (e.g. collating sequence) of tables in the
source file
- the size of the generated binary file.
-o output
output must be a file (option -VSINIX) or a directory (default or
option -V5.4). With option -V5.4 or by default, ic writes the
generated files and the shell script to the directory output. If
the -M option is set, @modifier is appended to the directory
name. It is your responsibility to ensure that the name does not
exceed a maximum length of 14 characters.
When the -VSINIX option is set, ic writes the generated binary
database to the file output.
-o output not specified:
The name of the output file or output directory is the name of
the CODESET section in the source file.
source
Name of the source file to be compiled.
source not specified: ic reads the source text from standard
input.
EXIT STATUS
0 for successful compilation
not 0 if a binary file or the intermediate files could not be gen-
erated due to errors
Page 2 Reliant UNIX 5.44 Printed 11/98
ic(1) ic(1)
ERROR MESSAGES
Four types of error message are issued by the ic compiler:
[warning]
The compiler has detected some kind of problem which has a high
probability of being an error but may also be what the user
wanted and has no adverse effect on the correctness of the gen-
erated file(s).
[error nn]
The compiler has detected an error severe enough to inhibit the
generation of a correct binary file or of correct intermediate
files.
[fatal error]
The compiler has detected an error which makes it impossible to
proceed with the compilation. This error usually occurs during
compilation of the code table.
[fatal bug]
An error message of this kind is issued when internal errors
occur in the compiler. As a side effect, temporary files which
may be needed to fix the bug are stored in the /tmp directory.
LOCALE
The LCMESSAGES environment variable governs the language in which
message texts are displayed. If LCMESSAGES is undefined or is defined
as the null string, it defaults to the value of LANG. If LANG is like-
wise undefined or null, the system acts as if it were not internation-
alized.
The LCALL environment variable governs the entire locale. LCALL
takes precedence over all the other environment variables which affect
internationalization.
FILES
/tmp/icXXXXXX
Temporary files
LCTIME
Intermediate file created by ic -V5.4
colltbl
Intermediate file created by ic -V5.4
chrtbl
Intermediate file created by ic -V5.4
montbl
Intermediate file created by ic -V5.4
Page 3 Reliant UNIX 5.44 Printed 11/98
ic(1) ic(1)
Xopeninfo
Intermediate file created by ic -V5.4
installlocale
Shell script created by ic -V5.4.
This shell script may only be run by the system administrator.
SEE ALSO
what(1).
Programmer's Guide, Internationalization - Localization.
Page 4 Reliant UNIX 5.44 Printed 11/98