Simple install procedure
========================

  % gzip -cd gini-0.4.tar.gz | tar xvf -    # unpack the sources
  % cd gini-0.4                             # change to the toplevel directory
  % ./configure                             # run the `configure' script
  % make                                    # build libgini

  [ Become root if necessary ]
  % make install                            # install libgini

Requirements
============

gini-0.4 requires pkg-config, which is tool for tracking the
compilation flags needed for libraries. (For each library, a small .pc
text file is installed in a standard location that contains the
compilation flags needed for that library along with version number
information.) Information about pkg-config can be found at:

  http://www.freedesktop.org/software/pkgconfig/

GLib-2.0 (http://www.gtk.org/), a low-level core library that forms the
basis of GTK+ and GNOME. It provides data structure handling for C,
portability wrappers, and interfaces for such runtime functionality as
an event loop, threads, dynamic loading, and an object system.

Recommended
===========

GNU make (http://www.gnu.org/software/make), a tool which controls the
generation of executables and other non-source files of a program from
the program's source files.

GNU Compiler Collection (http://gcc.gnu.org/), a compiler.

The Nitty-Gritty
================

The 'configure' script can be given a number of options to enable
and disable various features. For a complete list, type:

  ./configure --help

A few of the more important ones:

*  --prefix=PREFIX         install architecture-independent files in PREFIX
                           [ Defaults to /usr/local ]

*  --exec-prefix=EPREFIX   install architecture-dependent files in EPREFIX
                           [ Defaults to the value given to --prefix ]

Options can be given to the compiler and linker by setting
environment variables before running configure. A few of the more
important ones:

 CC       : The C compiler to use
 CPPFLAGS : Flags for the C preprocesser such as -I and -D
 CFLAGS   : C compiler flags

The most important use of this is to set the optimization/debugging
flags. For instance, to compile with no debugging information at all,
run configure as:

 CFLAGS=-O2 ./configure           # Bourne compatible shells (sh/bash/zsh)

or,

 setenv CFLAGS -O2 ; ./configure  # csh and variants

Installation directories
========================

The location of the installed files is determined by the --prefix
and --exec-prefix options given to configure. There are also more
detailed flags to control individual directories. However, the
use of these flags is not tested.

