
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 unrefer-
           enced 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.

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.

       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 val-
       ues.

       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,  overrid-
           ing 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 exe-
           cutable.

       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
       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 of Icon.  http://www.cs.arizona.edu/icon/v940.

CAVEATS
       Icon executables do not stand alone; the iconx interpreter
       must be available.

       Overflow of a coexpression  stack  can  produce  a  memory
       fault.

