ICON(1)                                                   ICON(1)

NAME
       icon - execute Icon program

SYNOPSIS
       icon sourcefile [ arg ... ]
       icon -P 'program' [ arg ... ]

DESCRIPTION
       Icon  is a simple interface for executing programs written
       in the Icon programming  language.   The  source  code  is
       translated  and  linked, then executed with the given list
       of arguments.

       Without -P, a single source file is read; its name must be
       given exactly and need not end in .icn.  A sourcefile name
       of - reads the source code from standard input.

       With -P, a small program can be embedded within  a  larger
       shell script.  In this case the program argument is a com-
       plete Icon program, typically given as a multi-line quoted
       string.

       Translation  and  linking  is silent, suppressing progress
       messages, and undeclared identifiers are diagnosed.   This
       mirrors the behavior of the icont command when run with -s
       and -u options.

       An Icon source file can be  made  directly  executable  by
       setting  the  appropriate permission bits and beginning it
       with a shell header.  If the first line of the file is
            #!/usr/bin/env icon
       then icon is found on the command search path  and  called
       to process the program upon execution.

ENVIRONMENT
       The  environment  variables  described  under icont(1) can
       also be used with the icon  command.   Normally,  none  of
       these are needed.

SEE ALSO
       icont(1),  the full-featured interface supporting separate
       compilation, multiple source files, and other features.

       The Icon Programming  Language.   Griswold  and  Griswold,
       Peer-to-Peer, third edition, 1996.

       Graphics  Programming  in  Icon.   Griswold,  Jeffery, and
       Townsend, Peer-to-Peer, 1998.

       Version 9.4.2 of Icon.
       http://www.cs.arizona.edu/icon/v942.

