Icon Shell Commands

icon — Icon simplified execution

Usage: icon sourcefile [arg...]
Usage: icon –P 'program' [arg...]

Without –P, a single source file is read and executed with the given arguments. With –P, the program is given as a multi-line quoted string. Environment variables of icont and iconx (see below) are used if present.

An Icon source file can be made directly executable by making its first line be

    #!/usr/bin/env icon

and setting its execute bit (chmod +x filename).

icont — Icon translator and linker

Usage: icont [option...] file...

Options

-c        translate only, without linking
-fs       prevent removal of all unreferenced declarations
          (same as "invocable all")
-o file   name the icode output file file
-p        enable execution profiling; implied by ICONPROFILE
-s        suppress progress messages
-t        give &trace an initial value of -1
-u        issue warnings for undeclared identifiers
-v n      set verbosity of output, where n = 
             0   suppress non-error output (same as -s)
             1   list procedure names (the default)
             2   also report the sizes of icode sections
                 (procedures, strings, and so forth)
             3   also list discarded globals
-E         preprocess only
-N         make executable more portable by omitting iconx path
-V         announce version and configuration information

Environment variables recognized by icont

Name         Default    Description
--------     -------    -----------------------
IPATH        none       search path for link directives
LPATH        none       search path for $include directives

Search paths are blank- or colon-separated lists of directories. The current directory is searched before a search path is used.

iconx — Icon interpreter

The Icon interpreter is normally invoked automatically when the name of an Icon program is entered as a command, but it can also be invoked explicitly:

iconx icode-file-name [arguments for Icon program]

Environment variables recognized at runtime

Name         Default    Description
--------     -------    -----------------------
TRACE              0    Initial value for &trace.
NOERRBUF   undefined    If set, &errout is not buffered.
STRSIZE       500000    Initial size (bytes) of string region (strings).
BLKSIZE       500000    Initial size (bytes) of block region (most objects).
COEXPSIZE       2000    Size (long words) of co-expression blocks.
MSTKSIZE       10000    Size (long words) of main interpreter stack.
ICONPROFILE     none    Output file for execution profile.