Gregg M. Townsend
Department of Computer Science
The University of Arizona
Last updated November 8, 2005
These instructions explain how to build and install the source code of Version 9.4 of Icon under Unix. For instructions on installing a binary release, see Installing Icon Binaries.
These instructions assume that you have unpacked the Icon distribution file into a directory. All commands are issued in that directory.
The Icon source package contains configurations for a variety of
make Configure to see the list of known configurations.
A status report for any system can be viewed by entering
Choose the configuration name that matches your system's operating system, and be sure to note any special considerations given in its status report.
make Status name=name
(If your system is not among those listed, you will need to port the code. This is usually a fairly simple matter that involves copying an existing configuration and editing it to match the target system. See Porting Icon.
Most Unix systems include the X11 window system; type
to configure Icon with graphics. If your computer does not have the X window system, type
make X-Configure name=name
to configure Icon without graphics.
make Configure name=name
Installation using any of the supplied configurations should be routine, but some of those were contributed for systems we cannot test, and it is possible that some minor tweaking may be required. If so, or if you develop a new configuration, we'd like to hear about it by e-mail to firstname.lastname@example.org.
After Configuring, type
make to build the Icon system.
This single step now builds:
There may be a few warnings on some platforms, but there should be
no fatal errors.
If there are problems,
fix them in the
directory and repeat the configuration step.
To verify a successful build, type
This command compiles and executes a series of Icon programs,
comparing their outputs with a set of standard results.
A normal run concludes with the phrase "All tests passed."
A successful graphics build can be confirmed by executing
bin/colrbook, the color book utility, with no arguments.
It should display a spectrum of colors along the left and a set
of recessed panes to the right.
Click anywhere on the spectrum to fill colors in the panes.
QUIT (in the upper left corner) to exit.
Icon can be run directly from the location in which it was built.
To do this, simply add the
bin directory to your shell's
See the man pages for
for instructions on building and running Icon programs.
If you wish to install the binaries elsewhere,
choose a location for a directory dedicated to Icon —
If you are replacing an existing directory, delete the old one first.
to create directory and install Icon in its
make Install dest=directory
mansubdirectories. All files are created using the default permissions (umask) of the current user.
You can make symbolic links from other locations
to programs in the Icon
For example, you can link
If you do this, link all of
iconx, and (if present)
If you'd like to bundle up a gzipped tar file of the binaries
created by the build process, enter
Such a package can be used to install binaries on other
systems of the same architecture.
make Clean to remove intermediate files created
during the build process. This command preserves the contents of the
lib directories, so the built system
To restore everything to its original state, type
This removes all the configuration information and newly built files.