summaryrefslogtreecommitdiff
path: root/man/man1/icont.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/man1/icont.1')
-rw-r--r--man/man1/icont.1138
1 files changed, 138 insertions, 0 deletions
diff --git a/man/man1/icont.1 b/man/man1/icont.1
new file mode 100644
index 0000000..c17a768
--- /dev/null
+++ b/man/man1/icont.1
@@ -0,0 +1,138 @@
+.TH ICONT 1 "9 August 2005" "University of Arizona"
+.SH NAME
+icont \- translate Icon program
+.SH SYNOPSIS
+\fBicont\fP [ option ... ] file ... [ \fB\-x\fP arg ... ]
+.SH DESCRIPTION
+Icont translates and links programs written in the Icon language.
+Translation produces \fIucode\fP files, suffixed \fB.u1\fP and \fB.u2\fP,
+which are linked to produce executable files.
+Icon executables are shell scripts containing binary data; this data is
+interpreted by \fBiconx\fP, which must be present at execution time.
+.PP
+File names ending in \fB.icn\fP are Icon source files;
+the \fB.icn\fP suffix may be omitted from command arguments.
+An argument of \fB\-\fP reads from standard input.
+A name ending in \fB.u\fP, \fB.u1\fP, or \fB.u2\fP selects both files
+of a ucode pair.
+The specified files are combined to produce a single program,
+which is named by removing the suffix from the first input file.
+.PP
+An argument of \fB\-x\fP may appear \fIafter\fP the file arguments
+to execute the linked program.
+Any subsequent arguments are passed to the program.
+.PP
+Ucode files produced by translation are normally deleted after linking.
+If the \fB\-c\fP option is given, processing stops after translation
+and the ucode files are left behind.
+A directory of such files functions as a linkable library.
+.SH OPTIONS
+The following options are recognized by \fIicont\fP:
+.TP 4
+\fB\-c\fP
+Stop after producing ucode files.
+.TP
+\fB\-f s\fP
+Enable full string invocation by preserving unreferenced procedures
+during linking.
+.TP
+\fB\-o \fIfile\fP
+Write the executable program to the specified file.
+.TP
+\fB\-s\fP
+Suppress informative messages during translation and linking.
+.TP
+\fB\-t\fP
+Activate runtime tracing by
+arranging for \fB&trace\fP to have an initial value of \-1
+upon execution.
+.TP
+\fB\-u\fP
+Diagnose undeclared identifiers.
+.TP
+\fB\-v \fIi\fP
+Set verbosity level of informative messages to \fIi\fB.
+.TP
+\fB\-E\fP
+Direct the results of preprocessing to standard output and inhibit
+further processing.
+.TP
+\fB\-N\fP
+Don't embed \fBiconx\fP path in executable file.
+.TP
+\fB\-V\fP
+Announce version and configuration information on standard error.
+.SH "TRANSLATION ENVIRONMENT"
+Two environment variables control file search paths during
+translation and linking.
+These variables contain blank- or colon-separated lists of directories
+to be searched after the current directory
+and before the standard library.
+.TP 4
+\fBIPATH\fP
+Directories to search for for ucode files
+specified in \fBlink\fP directives and on the command line.
+.TP 4
+\fBLPATH\fP
+Directories to search for source files
+specified in preprocessor \fB$include\fP directives.
+.SH "EXECUTION ENVIRONMENT"
+Several environment variables control the execution of an Icon program.
+Values in parentheses are the default values.
+.TP 4
+\fBBLKSIZE\fP (500000)
+The initial size, in bytes, of the allocated block region.
+.TP
+\fBCOEXPSIZE\fP (2000)
+The size, in words, of each co-expression stack.
+.TP
+\fBICONCORE\fP
+If set, a core dump is produced for error termination.
+.TP 4
+\fBICONX\fP
+The location of \fBiconx\fP, the icon interpreter,
+overriding the value built into the executable by \fBicont\fP.
+Not required if the configuration is unchanged since build time
+or if \fBiconx\fP is in the same directory as the executable.
+.TP
+\fBMSTKSIZE\fP (10000)
+The size, in words, of the main interpreter stack for \fBicont\fP.
+.TP
+\fBNOERRBUF\fP
+By default, \fB&errout\fP is buffered. If this variable is set, \fB&errout\fP
+is not buffered.
+.TP
+\fBQLSIZE\fP (5000)
+The size, in bytes, of the region used for pointers
+to strings during garbage collection.
+.TP
+\fBSTRSIZE\fP (500000)
+The initial size, in bytes, of the string space.
+.TP
+\fBTRACE\fP
+The initial value of \fB&trace\fP.
+If this variable has a value, it overrides the translation-time
+\fB\-t\fP
+option.
+.SH SEE ALSO
+\fBicon\fP(1), a simpler command interface
+for embedding Icon programs in scripts.
+.LP
+\fIThe Icon Programming Language\fP.
+Griswold and Griswold,
+Peer-to-Peer, third edition, 1996.
+.LP
+\fIGraphics Programming in Icon\fP.
+Griswold, Jeffery, and Townsend,
+Peer-to-Peer, 1998.
+.LP
+\fIVersion 9.4.3 of Icon\fP.
+.br
+http://www.cs.arizona.edu/icon/v943.
+.SH "CAVEATS"
+.LP
+Icon executables are not self-sufficient, but require the \fBiconx\fP
+interpreter.
+When distributing an Icon program in executable form, include a copy
+of \fBiconx\fP in the same directory.
+