Return to iclc.1 CVS log

Up to [Research Unix] / researchv10dc / man / mana

Annotation of researchv10dc/man/mana/iclc.1, revision 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.

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