home *** CD-ROM | disk | FTP | other *** search
/ ftp.cs.arizona.edu / ftp.cs.arizona.edu.tar / ftp.cs.arizona.edu / icon / historic / v941.tgz / icon.v941src.tar / icon.v941src / doc / icont.txt < prev    next >
Text File  |  2002-01-30  |  5KB  |  135 lines
  1.  
  2. NAME
  3.        icont - translate Icon program
  4.  
  5. SYNOPSIS
  6.        icont [ option ... ] file ... [ -x arg ... ]
  7.  
  8. DESCRIPTION
  9.        Icont  translates  and  links programs written in the Icon
  10.        language.  Translation produces ucode files, suffixed  .u1
  11.        and  .u2,  which  are  linked to produce executable files.
  12.        Icon executables are shell scripts containing binary data;
  13.        this  data  is interpreted by iconx, which must be present
  14.        at execution time.
  15.  
  16.        File names ending in .icn are Icon source files; the  .icn
  17.        suffix may be omitted from command arguments.  An argument
  18.        of - reads from standard input.  A name ending in .u, .u1,
  19.        or  .u2 selects both files of a ucode pair.  The specified
  20.        files are combined to produce a single program,  which  is
  21.        named by removing the suffix from the first input file.
  22.  
  23.        An  argument  of -x may appear after the file arguments to
  24.        execute the linked program.  Any subsequent arguments  are
  25.        passed to the program.
  26.  
  27.        Ucode  files  produced by translation are normally deleted
  28.        after linking.  If the  -c  option  is  given,  processing
  29.        stops  after  translation  and  the  ucode  files are left
  30.        behind.  A directory of such files functions as a linkable
  31.        library.
  32.  
  33. OPTIONS
  34.        The following options are recognized by icont:
  35.  
  36.        -c  Stop after producing ucode files.
  37.  
  38.        -f s
  39.            Enable  full  string invocation by preserving unrefer-
  40.            enced procedures during linking.
  41.  
  42.        -o file
  43.            Write the executable program to the specified file.
  44.  
  45.        -s  Suppress informative messages during  translation  and
  46.            linking.
  47.  
  48.        -t  Activate  runtime  tracing  by arranging for &trace to
  49.            have an initial value of -1 upon execution.
  50.  
  51.        -u  Diagnose undeclared identifiers.
  52.  
  53.        -v i
  54.            Set verbosity level of informative messages to i.
  55.  
  56.        -E  Direct the results of preprocessing to standard output
  57.            and inhibit further processing.
  58.  
  59.        -V  Announce  version  and  configuration  information  on
  60.            standard error.
  61.  
  62. TRANSLATION ENVIRONMENT
  63.        Two environment variables control file search paths during
  64.        translation  and  linking.  These variables contain blank-
  65.        or colon-separated lists of  directories  to  be  searched
  66.        after  the  current  directory  and  before  the  standard
  67.        library.
  68.  
  69.        IPATH
  70.            Directories to search for for ucode files specified in
  71.            link directives and on the command line.
  72.  
  73.        LPATH
  74.            Directories  to  search  for source files specified in
  75.            preprocessor $include directives.
  76.  
  77. EXECUTION ENVIRONMENT
  78.        Several environment variables control the execution of  an
  79.        Icon  program.  Values in parentheses are the default val-
  80.        ues.
  81.  
  82.        BLKSIZE (500000)
  83.            The initial size, in bytes,  of  the  allocated  block
  84.            region.
  85.  
  86.        COEXPSIZE (2000)
  87.            The size, in words, of each co-expression stack.
  88.  
  89.        ICONCORE
  90.            If set, a core dump is produced for error termination.
  91.  
  92.        ICONX
  93.            The location of iconx, the icon interpreter,  overrid-
  94.            ing the value built into the executable by icont.  Not
  95.            required if the configuration is unchanged since build
  96.            time  or if iconx is in the same directory as the exe-
  97.            cutable.
  98.  
  99.        MSTKSIZE (10000)
  100.            The size, in words, of the main interpreter stack  for
  101.            icont.
  102.  
  103.        NOERRBUF
  104.            By  default, &errout is buffered.  If this variable is
  105.            set, &errout is not buffered.
  106.  
  107.        QLSIZE (5000)
  108.            The size, in bytes, of the region used for pointers to
  109.            strings during garbage collection.
  110.  
  111.        STRSIZE (500000)
  112.            The initial size, in bytes, of the string space.
  113.  
  114.        TRACE
  115.            The  initial  value of &trace.  If this variable has a
  116.            value, it overrides the translation-time -t option.
  117.  
  118. SEE ALSO
  119.        icon(1), a simpler command interface  for  embedding  Icon
  120.        programs in scripts.
  121.  
  122.        The  Icon  Programming  Language.   Griswold and Griswold,
  123.        Peer-to-Peer, third edition, 1996.
  124.  
  125.        Graphics Programming  in  Icon.   Griswold,  Jeffery,  and
  126.        Townsend, Peer-to-Peer, 1998.
  127.  
  128.        Version 9.4.1 of Icon.
  129.        http://www.cs.arizona.edu/icon/v941.
  130.  
  131. CAVEATS
  132.        Icon executables do not stand alone; the iconx interpreter
  133.        must be available.
  134.  
  135.