|
|
1.1 root 1: .TH ICLC 1 "1 July 1988"
2: .SH NAME
3: iclc \- Esterel binder
4: .SH SYNOPSIS
5: .B iclc
6: [ option ] ... [ file ]...
7: .SH DESCRIPTION
8: \fIiclc\fR is the Esterel v3 binder.
9: It produces an \fIlc\fR format output
10: (or \fIic\fR if some \fBcopymodule\fP instruction
11: could not be expanded) from one or more \fIic\fR format inputs.
12: If there is no input file, the standard input is used.
13: \fIic\fP format input describes Esterel \fBmodules\fP to be processed,
14: and \fIlc\fP format output describes Esterel \fBmodules\fP with
15: no \fBcopymodule\fP instruction.
16: Typical use is:
17: .br
18: .DS
19: iclc < game1.ic > game.lc
20: .DE
21: .br
22: or
23: .br
24: .DS
25: iclc game1.ic game2.ic > game.lc
26: .DE
27: .LP
28: The following options are interpreted by \fIiclc\fP:
29: .IP \fB-v\fR 10
30: Verbose mode. Tells what's going on.
31: .IP \fB-version\fR 10
32: Prints the version number and exits.
33: .IP \fB-stat\fR 10
34: Prints times and memory sizes for the main phases.
35: .IP \fB-memstat\fR 10
36: Gives the memory allocator state at the end of processing.
37: .IP \fB-Rs\fR 10
38: Signal renaming trace mode.
39: .IP \fB-Rc\fR 10
40: Constant renaming trace mode.
41: .IP \fB-cascade\fR 10
42: "Cascade" mode. Creates a file FOO.casc
43: using the -o, -B and -D options to find the name
44: (esterel.casc as a last resort).
45: .IP "\fB\-B\fP \fIname\fP" 10
46: Basename for the auxiliary output file.
47: .IP "\fB-D\fP \fIname\fP" 10
48: The name of the directory where the auxiliary output file will go.
49: For instance,
50: .br
51: iclc -D /users/john/wd -B game -cascade game*.ic
52: .br
53: will write in the file "/users/john/wd/game.casc".
54: .IP "\fB\-d\fP[level]" 10
55: Debug mode. Barely for you.
56: .IP "\fB\-o\fP \fIname\fP" 10
57: Names the final output file \fIname\fP (deleting the existing text).
58: Obsolete.
59: .IP \fB-\fR 10
60: Specifies the standard input as input stream. Works only once. Obsolete.
61: .SH FILES
62: The caller of the command
63: must have read/write permission for the directories containing
64: the working files, and execute permission for the \fIiclc\fR file itself.
65: .SH DIAGNOSTICS
66: The diagnostics produced by \fIiclc\fR compiler are intended (as usual)
67: to be self-explanatory.
68: They have one of the following forms:
69: .IP
70: "file",line n: iclc error (or warning) : message
71: .IP
72: *** iclc: message
73: .IP
74: >>>iclc s_trace (or c_trace) : message
75: .LP
76: The first two forms are described in the \fIError Messages Manual\fR.
77: The last one is
78: generated by the -Rs or -Rc option.
79: The possible messages with -Rc are:
80: .IP "root module FOO:"
81: the binder begins to treat the root module FOO.
82: .IP "submodule /FOO/BAR:"
83: the binder begins to treat the module BAR, "called"
84: by module FOO.
85: .LP
86: CONSTANT added as @33 <<:
87: .IP
88: CONSTANT is added to the list of final
89: constants with number 33. The "<<" is here
90: to help you find later the name of constant
91: number 33. Just look upward for 33 followed by "<<".
92: .LP
93: CONSTANT captured by @33 in module /FOO/BAR:
94: .IP
95: CONSTANT is implicitly captured by final constant
96: number 33 which was defined in module /FOO/BAR.
97: .LP
98: CONSTANT replaced by @33 in module /FOO/BAR:
99: .IP
100: CONSTANT is explicitly renamed to final
101: constant number 33 by a copymodule instruction defined in module /FOO/BAR.
102: .LP
103: Messages generated by -Rs are alike, except that no module name is given
104: (all signals must be defined in the parent module).
105:
106: .SH IDENTIFICATION
107: .de VL
108: \\$2
109: ..
110: Author: J-M. Tanzi,
111: CMA, Ecole des Mines de Paris,
112: .sp 0
113: Sophia-Antipolis, 06600 Valbonne, FRANCE
114: .sp 0
115: Revision Number:
116: $Revision: 1.3 $
117: ; Release Date:
118: $Date: 88/07/04 10:32:28 $
119: \&.
120: .SH SEE ALSO
121: Esterel v3 Programming Language Manual
122: .sp 0
123: Esterel v3 System Manuals.
124: .sp 0
125: strlic (1), lcoc(1), ocl (1).
126: .sp 0
127: .SH BUGS
128: .IP -
129: error messages should point to the Esterel source code
130: and not to an intermediate code input file.
131: .IP -
132: there is no error message if the same signal or constant
133: appears more than once in a renaming list. Only one renaming
134: is applied, however.
135: .IP -
136: the "cascade" mode in not fully implemented.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.