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 complete 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.3 of Icon.
       http://www.cs.arizona.edu/icon/v943.