NAME

       icont - translate Icon program

SYNOPSIS

       icont [ option ... ] file ... [ -x arg ... ]

DESCRIPTION

       Icont  translates  and  links  programs  written in the Icon language.  Translation produces ucode files,
       suffixed .u1 and .u2, which are linked to produce executable files.  Icon executables are  shell  scripts
       containing binary data; this data is interpreted by iconx, which must be present at execution time.

       File  names  ending in .icn are Icon source files; the .icn suffix may be omitted from command arguments.
       An argument of - reads from standard input.  A name ending in .u, .u1, or .u2 selects  both  files  of  a
       ucode pair.  The specified files are combined to produce a single program, which is named by removing the
       suffix from the first input file.

       An argument of -x may appear after the file arguments to execute  the  linked  program.   Any  subsequent
       arguments are passed to the program.

       Ucode  files  produced  by  translation  are  normally deleted after linking.  If the -c option is given,
       processing stops after translation and the ucode files are  left  behind.   A  directory  of  such  files
       functions as a linkable library.

OPTIONS

       The following options are recognized by icont:

       -c  Stop after producing ucode files.

       -f s
           Enable full string invocation by preserving unreferenced procedures during linking.

       -o file
           Write the executable program to the specified file.

       -s  Suppress informative messages during translation and linking.

       -t  Activate runtime tracing by arranging for &trace to have an initial value of -1 upon execution.

       -u  Diagnose undeclared identifiers.

       -v i
           Set verbosity level of informative messages to i.

       -E  Direct the results of preprocessing to standard output and inhibit further processing.

       -N  Don't embed iconx path in executable file.

       -V  Announce version and configuration information on standard error.

TRANSLATION ENVIRONMENT

       Two  environment  variables  control  file  search paths during translation and linking.  These variables
       contain blank- or colon-separated lists of directories to be searched after  the  current  directory  and
       before the standard library.

       IPATH
           Directories to search for for ucode files specified in link directives and on the command line.

       LPATH
           Directories to search for source files specified in preprocessor $include directives.

EXECUTION ENVIRONMENT

       Several  environment  variables  control the execution of an Icon program.  Values in parentheses are the
       default values.

       BLKSIZE (500000)
           The initial size, in bytes, of the allocated block region.

       COEXPSIZE (2000)
           The size, in words, of each co-expression stack.

       ICONCORE
           If set, a core dump is produced for error termination.

       ICONX
           The location of iconx, the icon interpreter, overriding the value built into the executable by icont.
           Not  required if the configuration is unchanged since build time or if iconx is in the same directory
           as the executable.

       MSTKSIZE (10000)
           The size, in words, of the main interpreter stack for icont.

       NOERRBUF
           By default, &errout is buffered.  If this variable is set, &errout is not buffered.

       QLSIZE (5000)
           The size, in bytes, of the region used for pointers to strings during garbage collection.

       STRSIZE (500000)
           The initial size, in bytes, of the string space.

       TRACE
           The initial value of &trace.  If this variable has a value,  it  overrides  the  translation-time  -t
           option.

SEE ALSO

       icon(1), a simpler command interface for embedding Icon programs in scripts.

       The Icon Programming Language.  Griswold and Griswold, Peer-to-Peer, third edition, 1996.

       Graphics Programming in Icon.  Griswold, Jeffery, and Townsend, Peer-to-Peer, 1998.

       Version 9.4.3 of Icon.
       http://www.cs.arizona.edu/icon/v943.

CAVEATS

       Icon  executables  are not self-sufficient, but require the iconx interpreter.  When distributing an Icon
       program in executable form, include a copy of iconx in the same directory.