icont(1) - f37

1ICONT(1)                    General Commands Manual                   ICONT(1)
2
3
4

NAME

6       icont - translate Icon program
7

SYNOPSIS

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

DESCRIPTION

12       Icont  translates  and  links  programs  written  in the Icon language.
13       Translation produces ucode files,  suffixed  .u1  and  .u2,  which  are
14       linked to produce executable files.  Icon executables are shell scripts
15       containing binary data; this data is interpreted by iconx,  which  must
16       be present at execution time.
17
18       File names ending in .icn are Icon source files; the .icn suffix may be
19       omitted from command arguments.  An argument of - reads  from  standard
20       input.   A name ending in .u, .u1, or .u2 selects both files of a ucode
21       pair.  The specified files are combined to produce  a  single  program,
22       which is named by removing the suffix from the first input file.
23
24       An  argument  of  -x may appear after the file arguments to execute the
25       linked program.  Any subsequent arguments are passed to the program.
26
27       Ucode files produced by translation are normally deleted after linking.
28       If  the  -c option is given, processing stops after translation and the
29       ucode files are left behind.  A directory of such files functions as  a
30       linkable library.
31

OPTIONS

33       The following options are recognized by icont:
34
35       -c  Stop after producing ucode files.
36
37       -f s
38           Enable full string invocation by preserving unreferenced procedures
39           during linking.
40
41       -o file
42           Write the executable program to the specified file.
43
44       -p  Enable execution-time profiling; implied if ICONPROFILE is set  and
45           not empty.
46
47       -s  Suppress informative messages during translation and linking.
48
49       -t  Activate runtime tracing by arranging for &trace to have an initial
50           value of -1 upon execution.
51
52       -u  Diagnose undeclared identifiers.
53
54       -v i
55           Set verbosity level of informative messages to i.
56
57       -E  Direct the results of preprocessing to standard output and  inhibit
58           further processing.
59
60       -N  Don't embed iconx path in executable file.
61
62       -V  Announce version and configuration information on standard error.
63

TRANSLATION ENVIRONMENT

65       Two  environment variables control file search paths during translation
66       and linking.  These variables contain blank- or  colon-separated  lists
67       of  directories  to  be searched after the current directory and before
68       the standard library.
69
70       IPATH
71           Directories to search for for ucode files specified in link  direc‐
72           tives and on the command line.
73
74       LPATH
75           Directories  to  search  for source files specified in preprocessor
76           $include directives.
77

EXECUTION ENVIRONMENT

79       Several environment variables control the execution of an Icon program.
80       Values in parentheses are the default values.
81
82       BLKSIZE (500000)
83           The initial size, in bytes, of the allocated block region.
84
85       COEXPSIZE (2000)
86           The size, in words, of each co-expression stack.
87
88       ICONCORE
89           If set, a core dump is produced for error termination.
90
91       ICONPROFILE
92           If  set,  specifies  a file to which profiling data is written upon
93           termination of a program linked with the -p option.  The output re‐
94           ports timer ticks and visit counts for each line executed.
95
96       ICONX
97           The  location  of iconx, the icon interpreter, overriding the value
98           built into the executable by icont.  Not required if the configura‐
99           tion  is  unchanged since build time or if iconx is in the same di‐
100           rectory as the executable.
101
102       MSTKSIZE (10000)
103           The size, in words, of the main interpreter stack for icont.
104
105       NOERRBUF
106           By default, &errout is buffered.  If this variable is set,  &errout
107           is not buffered.
108
109       QLSIZE (5000)
110           The size, in bytes, of the region used for pointers to strings dur‐
111           ing garbage collection.
112
113       STRSIZE (500000)
114           The initial size, in bytes, of the string space.
115
116       TRACE
117           The initial value of &trace.  If this  variable  has  a  value,  it
118           overrides the translation-time -t option.
119

CAVEATS

136       Icon executables are not self-sufficient, but require the iconx  inter‐
137       preter.   When distributing an Icon program in executable form, include
138       a copy of iconx in the same directory.
139
140
141
142
143University of Arizona             4 June 2013                         ICONT(1)