
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.

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

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.

