Department of Computer
Science The University of Arizona Tucson, Arizona IPD243f May 17, 1999 http://www.cs.arizona.edu/icon/docs/ipd243.htm |
There are Makefile
entries for most steps. Those steps are
marked by asterisks. Steps that are optional are enclosed in brackets:
1. Decide where to unload Icon. 2. Unload the Icon hierarchy at the selected place. 3* Check the status of the configuration for your system. 4* Configure the source code for your system. 5* Compile Icon. 6* Run simple tests. [7*] Run extensive tests. [8*] Run benchmarks. [9.] Install Icon at the desired place.
make
is with respect to the Makefile
at the top level of this hierarchy.
"."
.
Icon is distributed in a variety of formats. It requires about 20 MB of
disk space when unloaded. The amount of space it takes to build Icon depends
on the platform, what components are built, and whether intermediate files
are deleted between building components.|-bin------ executable binaries and support files | |-config---|-unix------ UNIX configuration directories | | |-common---- common source | |-h--------- header files | |-iconc----- Icon compiler source |-icon----|-src------|-icont----- Icon translator source | |-preproc--- preprocessor source | |-rtt------- run-time translator source | |-runtime--- run-time source | |-xpm------- XPM support | | |-bench----- benchmarks | |-calling--- calling C functions | |-general--- general tests |-tests----|-graphics-- graphics tests |-samples--- sample programsThere are additional subdirectories that are not shown above.
where name is one of those given in the table in the appendix at the end of this report. For example,make Status name=name
lists the status of the configuration for a PC running Linux.make Status name=intel_linux
wheremake Configure name=name
name
is the name of your platform as described above.
For example,
configures Version 9 of Icon for Linux, but without graphics facilities.make Configure name=intel_linux
X-Configure
instead of Configure
, as in
Note: On some platforms, error exit codes from installation processes may be intercepted bymake X-Configure name=intel_linux
make
and result in warning messages. These
messages can be safely ignored.config/unix
(see Reference 2) and restart from the make X-Configure
step.
There may be warning messages on some platforms, but there should be no fatal errors.make Icon
This test compares local program output with the expected output. There should be no differences. If there are no differences, you presumably have a running installation of Icon.make Samples
Some differences are to be expected, since tests include date, time, local host information, and platform-specific formats for floating-point numbers. In addition tomake Test
Test
there are some individual tests of optional
features. See the main Makefile
for more information about
the tests.gpxtest.icn
in test/graphics
.
It should build and run without error, producing a window similar to the
GIF image gpxtest.gif
in the same area.
See also the other material in the subdirectorymake Benchmark
tests/bench
.
It contains a form that you can use to record your benchmarks with the Icon
Project (see Section 9).
bin
in the Icon
hierarchy as the result of building the Icon interpreter:
Some other files related to installing Icon and the optional components mentioned earlier also are placed inicont Icon translator iconx Icon interpreter
bin
. The executable files
needed to run Icon -- icont
and iconx
-- can be
copied or moved to any desired place, and they need not be in the same directory.icont
must know the location of iconx
, it
is necessary to patch icont
if iconx
is moved.
The program patchstr
, also installed in bin
, is
provided for this purpose. It is used as follows:
For example, ifpatchstr icont-location iconx-location
icont
is moved to /usr/local/icont
and iconx
is moved to /usr/local/icon/iconx
, the
patching step is
Patching can be repeated if necessary. The patch value can be checked by usingpatchstr /usr/local/icont /usr/local/icon/iconx
patchstr
without a second argument, as in
which prints the path topatchstr /usr/local/icont
iconx
in /usr/local/icont
.
If you copied components of Icon to other places, you can delete the copies left in the Icon hierarchy.make Clean
Icon ProjectPlease also let us know if you have any suggestions for improvements to the installation process or corrections or refinements to configuration information.
Department of Computer Science
The University of Arizona
P.O. Box 210077
Tucson, AZ 85721-0077
U.S.A.
(520) 621-6613 (voice)
(520) 621-4246 (fax)
icon-project@cs.arizona.edu
computer operating system name * Compaq/DEC Alpha Linux alpha_linux * Compaq/DEC Alpha Tru64, Digital Unix, OSF/1 alpha_tru64 Hewlett-Packard HP-UX, cc hp_risc Hewlett-Packard HP-UX, Gnu C hp_risc_gcc * Intel-based PC BeOS intel_beos Intel-based PC BSD/OS intel_bsdos Intel-based PC FreeBSD intel_freebsd * Intel-based PC Linux intel_linux Intel-based PC Solaris intel_solaris Intel-based PC System V intel_sysv * IBM RS/6000 AIX ppc_aix * Silicon Graphics Irix sgi_irix Sun SPARC Linux sun_linux * Sun SPARC Solaris 2.x, SunPro C sun_sunc * Sun SPARC Solaris 2.x, Gnu C sun_gcc * Sun SPARC Solaris 2.x, CenterLine C sun_clcc