Inti: Integrated Foundation classes
Copyright (C) 2002-2003, The Inti Development Team.

1. What is Inti?
----------------
Inti is a set of integrated C++ foundation classes for
developing GTK+ applications on UNIX-like systems such
as Linux.

Inti combines the power of GTK+ and the power of C++ into a 
state-of-the-art GUI toolkit that makes developing applications
easy, intuitive and efficient. There are more than 330 classes
that wrap most of the objects found in the ATK, GDK, GDK-PIXBUF,
GLib, GTK and Pango libraries. It has its own system of signals
and slots which make using native GTK signals or creating your
own signals easy. There is a standard string compatible UTF-8 
string class, a full set of simple example programs, a GNU 
Autotools test project, a C++ version of the GTK+ demonstration
program, extensive reference documentation and a tutorial.


2. Minimum Requirements for Version 1.2.0.
------------------------------------------
 
 - atk-1.2.0
 - gthread-2.2.1
 - gtk+-2.2.1
 - pango-1.2.0
 - pkg-config-0.14

3. Installation.
----------------

First, if you downloaded the CVS version of Inti:
 
run:	./autogen.sh

If you have GTK+-2.2.1 or pkg-config-0.14 installed in a
non-standard directory you will have to edit autogen.sh
first and add your local aclocal directory as an include 
option after aclocal (e.g. aclocal -I $HOME/share/aclocal).

Next, if you downloaded the tarball version of Inti, or have
already run "./autogen.sh" then,

run:	./configure
	make

Don't forget to specify "--prefix=directory" with configure
if you want to install Inti in some directory other than
/usr/local.

If you want to install the Inti library complete with debugging
and compiler symbols, so you can debug your applications properly
then,

run:	make install

If you want to install the Inti library with all debugging symbols
stripped out then instead,

run:	install-strip

This will install a much smaller and faster library but you wont
be able to debug your programs properly.


4. Documentation.
-----------------
The docs/tutorial subdirectory contains an extensive tutorial
that works through all the example programs in the examples
subdirectory.

The docs/reference subdirectory contains the complete reference
documentation for the Inti library. This documentation was
compiled with doxygen 1.3.2 from special comments in the Inti
header files. If you downloaded the CVS version you will have 
to compile the documentation yourself. Just follow the directions
in the docs/README file.

The docs/faq subdirectory contains the Inti FAQ sheet, so if you
have a question, you might find the answer there.


5. Example Programs.
--------------------
The demos/inti-demo subdirectory contains the Inti widget demo
program. This is a direct C++ port of the GTK+ demo program that 
comes with the latest version of GTK+. The inti-demo program has
a lot of good example code that shows you how to use the library.
You can also directly compare how Inti does things in C++, with
how GTK+ does the same things in C.

The examples subdirectory contains all the example applications 
that the tutorial discusses and works through. They can be
compiled individually, or all at once by running "make" in the
examples subdirectory. The examples are not compiled by default.
You have to compile them.


6. The Test Project.
--------------------
Programmers new to GNU/Linux often need help getting started with
a GNU project. Look no further! Inti comes with a GNU Autotools
test project ready to build, in the tests/project/ subdirectory.
The Inti tutorial takes you step-by-step through the process of
building the project, and then shows you how to add international
support.


7. Contact.
-----------
Please, take the time to compile Inti and try it out. If you find
any bugs, or need any help programming with Inti let us know - at
<inti-mail@lists.sourceforge.net>.


The Inti Development Team.
