diff options
Diffstat (limited to 'static/unix-v10/man1/iclc.1')
| -rw-r--r-- | static/unix-v10/man1/iclc.1 | 136 |
1 files changed, 136 insertions, 0 deletions
diff --git a/static/unix-v10/man1/iclc.1 b/static/unix-v10/man1/iclc.1 new file mode 100644 index 00000000..5f1ad4cb --- /dev/null +++ b/static/unix-v10/man1/iclc.1 @@ -0,0 +1,136 @@ +.TH ICLC 1 "1 July 1988" +.SH NAME +iclc \- Esterel binder +.SH SYNOPSIS +.B iclc +[ option ] ... [ file ]... +.SH DESCRIPTION +\fIiclc\fR is the Esterel v3 binder. +It produces an \fIlc\fR format output +(or \fIic\fR if some \fBcopymodule\fP instruction +could not be expanded) from one or more \fIic\fR format inputs. +If there is no input file, the standard input is used. +\fIic\fP format input describes Esterel \fBmodules\fP to be processed, +and \fIlc\fP format output describes Esterel \fBmodules\fP with +no \fBcopymodule\fP instruction. +Typical use is: +.br +.DS +iclc < game1.ic > game.lc +.DE +.br +or +.br +.DS +iclc game1.ic game2.ic > game.lc +.DE +.LP +The following options are interpreted by \fIiclc\fP: +.IP \fB-v\fR 10 +Verbose mode. Tells what's going on. +.IP \fB-version\fR 10 +Prints the version number and exits. +.IP \fB-stat\fR 10 +Prints times and memory sizes for the main phases. +.IP \fB-memstat\fR 10 +Gives the memory allocator state at the end of processing. +.IP \fB-Rs\fR 10 +Signal renaming trace mode. +.IP \fB-Rc\fR 10 +Constant renaming trace mode. +.IP \fB-cascade\fR 10 +"Cascade" mode. Creates a file FOO.casc +using the -o, -B and -D options to find the name +(esterel.casc as a last resort). +.IP "\fB\-B\fP \fIname\fP" 10 +Basename for the auxiliary output file. +.IP "\fB-D\fP \fIname\fP" 10 +The name of the directory where the auxiliary output file will go. +For instance, +.br +iclc -D /users/john/wd -B game -cascade game*.ic +.br +will write in the file "/users/john/wd/game.casc". +.IP "\fB\-d\fP[level]" 10 +Debug mode. Barely for you. +.IP "\fB\-o\fP \fIname\fP" 10 +Names the final output file \fIname\fP (deleting the existing text). +Obsolete. +.IP \fB-\fR 10 +Specifies the standard input as input stream. Works only once. Obsolete. +.SH FILES +The caller of the command +must have read/write permission for the directories containing +the working files, and execute permission for the \fIiclc\fR file itself. +.SH DIAGNOSTICS +The diagnostics produced by \fIiclc\fR compiler are intended (as usual) +to be self-explanatory. +They have one of the following forms: +.IP +"file",line n: iclc error (or warning) : message +.IP +*** iclc: message +.IP +>>>iclc s_trace (or c_trace) : message +.LP +The first two forms are described in the \fIError Messages Manual\fR. +The last one is +generated by the -Rs or -Rc option. +The possible messages with -Rc are: +.IP "root module FOO:" +the binder begins to treat the root module FOO. +.IP "submodule /FOO/BAR:" +the binder begins to treat the module BAR, "called" +by module FOO. +.LP +CONSTANT added as @33 <<: +.IP +CONSTANT is added to the list of final +constants with number 33. The "<<" is here +to help you find later the name of constant +number 33. Just look upward for 33 followed by "<<". +.LP +CONSTANT captured by @33 in module /FOO/BAR: +.IP +CONSTANT is implicitly captured by final constant +number 33 which was defined in module /FOO/BAR. +.LP +CONSTANT replaced by @33 in module /FOO/BAR: +.IP +CONSTANT is explicitly renamed to final +constant number 33 by a copymodule instruction defined in module /FOO/BAR. +.LP +Messages generated by -Rs are alike, except that no module name is given +(all signals must be defined in the parent module). + +.SH IDENTIFICATION +.de VL +\\$2 +.. +Author: J-M. Tanzi, +CMA, Ecole des Mines de Paris, +.sp 0 +Sophia-Antipolis, 06600 Valbonne, FRANCE +.sp 0 +Revision Number: +$Revision: 1.3 $ +; Release Date: +$Date: 88/07/04 10:32:28 $ +\&. +.SH SEE ALSO +Esterel v3 Programming Language Manual +.sp 0 +Esterel v3 System Manuals. +.sp 0 +strlic (1), lcoc(1), ocl (1). +.sp 0 +.SH BUGS +.IP - +error messages should point to the Esterel source code +and not to an intermediate code input file. +.IP - +there is no error message if the same signal or constant +appears more than once in a renaming list. Only one renaming +is applied, however. +.IP - +the "cascade" mode in not fully implemented. |