![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to icont.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [Research Unix] / researchv10dc / man / mana|
Return to icont.1 CVS log | Up to [Research Unix] / researchv10dc / man / mana |
1.1 root 1: .TH ICONT 1 alice
2: .SH NAME
3: icont, iconc \- Icon language translator and compiler
4: .SH SYNOPSIS
5: .B icont
6: [ option ... ] file ... [
7: .B \-x
8: arg ... ]
9: .PP
10: .B iconc
11: [ option ... ] file ...
12: .SH DESCRIPTION
13: .I Icont
14: translates Version 5 of the Icon programming language
15: to an intermediate form, and link edits intermediate files
16: to interpretable files.
17: .I Iconc
18: does the same, but finally compiles to machine code.
19: Unless the
20: .B \-o
21: option is specified, the name of the linked file is
22: formed by deleting the suffix of the first input file named on the
23: command line.
24: Option
25: .B \-x
26: invokes the interpreter and passes the
27: .I args
28: to the Icon program.
29: .PP
30: Files whose names end in `.icn' are assumed to be Icon source programs;
31: files whose names end in `.u1' or `.u2' are assumed to be intermediate
32: files from a previous translation
33: (only one should be named \(em the other is assumed).
34: Unnamed .u1 and .u2 files are deleted.
35: The argument
36: .B \-
37: signifies the use of standard input as a source file.
38: .PP
39: The following options are recognized by
40: .IR icont .
41: .TP
42: .B \-c
43: Suppress linking and loading; preserve intermediate files.
44: .TP
45: .B \-m
46: Preprocess each `.icn' source file
47: with the
48: .IR m4 (1)
49: macro processor before translation.
50: .TP
51: .BI \-o " output"
52: Name the interpretable file
53: .IR output .
54: .TP
55: .B \-s
56: Suppress informative messages.
57: .TP
58: .B \-t
59: Arrange for
60: .I trace
61: to have an initial value of \-1
62: instead of 0 when the program is executed.
63: .TP
64: .B \-u
65: Issue warning messages for undeclared identifiers.
66: .PP
67: To run either and interpreatable or an executable file,
68: simply execute it as a command.
69: The following environment variables \- all numeric \- affect execution:
70: .TP
71: .I TRACE
72: Initialize the value of
73: .I trace,
74: overriding the translation option
75: .BR \-t .
76: .TP
77: .I NBUFS
78: The number of i/o buffers to use for files, normally 3.
79: .I input
80: and
81: .I output
82: are buffered unless they are terminals.
83: .I errout
84: is never buffered.
85: .TP
86: .I STRSIZE
87: The initial size of the string space, in bytes,
88: normally 51200.
89: .TP
90: .I HEAPSIZE
91: The initial size of the heap, in bytes, normally 51200.
92: .TP
93: .I NSTACKS
94: The number of stacks initially available for co-expressions,
95: normally 4.
96: .TP
97: .I STKSIZE
98: The size of each co-expression stack, in words, normally, 2000.
99: .TP
100: .I PROFILE
101: Turn on execution profiling of the runtime system.
102: The value of this variable specifies the sampling resolution, in words.
103: If the value is zero, profiling is not done.
104: The profiling results are left in a file `mon.out' for
105: interpretation by
106: .IR prof (1).
107: .SH FILES
108: .ta \w'v5v/int/bin/utran 'u
109: v5v/int/bin/utran icon translator
110: .br
111: v5v/int/bin/ulink icon linker
112: .br
113: v5v/cmp/bin/libi.a icon runtime library
114: .br
115: v5v/int/bin/iconx icon interpreter
116: .br
117: mon.out results of profiling
118: .br
119: *.u1, *.u2 intermediate files
120: .SH SEE ALSO
121: .I "Reference Manual for the Icon Programming Language, Version"
122: .IR 5 ,
123: Technical Report TR 81\-4a,
124: Department of Computer Science,
125: The University of Arizona,
126: Tucson, Arizona,
127: December 1981.
128: .br
129: .I Co-Expressions in Icon,
130: Technical Report TR 82\-4,
131: Department of Computer Science,
132: The University of Arizona.
133: .br
134: iconc(1), m4(1), prof(1), exec(2), monitor(3)
135: .SH BUGS
136: If the
137: .B \-m
138: option is used,
139: line numbers reported in error messages or tracing messages
140: are from the file after, not before, preprocessing.
141: .br
142: Integer overflow on multiplication is not detected.
143: .br
144: An interpretable
145: file produced on one system will not work on another system unless
146: the Icon interpreter is in the same place on both systems.
147: .br
148: Because of the way that co-expressions are implemented,
149: there is a possibility that programs
150: in which they are used may malfunction mysteriously.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.