Annotation of researchv10dc/man/mana/iclc.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.