Step-by-Step Instructions

1. Unpack the distribution.

   If the distribution came in a file with a name of the form giggle-m.n.tar.gz, you can unpack it like this: zcat giggle-m.n.tar.gz |tar xf -.

   If the distribution came in a file with a name of the form giggle-m.n.cpio.bz2, you can unpack it like this: bzcat giggle-m.n.cpio.bz2 |cpio -i.^8.1

   Either way, you'll end up with a directory called giggle-m.n in the current directory.

2. ``cd giggle-m.n''

3. ``./configure''

   Running ./configure with no options will setup Giggle to install with default options. It'll prepare Giggle to install in /usr/local/. You can configure some things by giving command line options to ``./configure''. Run ``./configure --help'' on the command line to see a list of possible options.

4. ``make''

   This builds the Giggle library, test programs, & demo programs.

5. ``make check''

   This runs the Giggle test programs. In general, a test program prints nothing if it works. Let me restate that: If a test program succeeds, it doesn't print anything. If all the tests work, you'll see a list of the tests that ran; the list was printed by make. You won't see any other output. If a test fails, it will print a diagnostic message, & the make will fail.^8.2

   The tests for the Boehm collector warn that some objects were not collected. Please disregard this for now.

6. ``make install''

   This will install Giggle. It will install libcybertiggyr-giggle-m.n.a in your lib directory & create libcybertiggyr-giggle.a as a symlink to it. It will install the header files in directory CyberTiggyr/giggle-m.n in your include directory and create CyberTiggyr/giggle as a symlink to it.

   See Directories & Files (section 8.2) for the details of what is installed where.

7. You're done!