Return to icont.1 CVS log

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

Annotation of researchv10dc/man/mana/icont.1, revision 1.1

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.