This is Iguana version 0.1.3
============================

Welcome to Iguana!

First of all, thanks a lot to download Iguana, I hope that you can enjoy it.


Copyright notice
----------------

Copyright (C) 2002, 2003 Davide Angelocola <davide.angelocola@tiscali.it>
All rights reserved.


License information
-------------------

Iguana is free software released under the GNU Public License. It gives you, 
as user, a great deal of liberty, which proprietary software just doesn't. 

Follows a little list of the advantages Iguana has:
  o  it's free!
  o  the complete source code is available
  o  you are allowed to copy, modify and redistribute. For more info
     about this subject refer to the LICENSE
  o  you can join the development of the language in a open way
 

What's news in this version?
----------------------------

See the Misc/CHANGES for information on new features and other user-visible 
changes in this version of Iguana.
 
For information about older versions, consult the Misc/HISTORY file.


If you don't read instructions
------------------------------

To start building right away type `./configure' in the current directory and 
when it finishes, type `make'.  This creates an executable `iguana'; to 
install in /usr/local, first do `su root' and then `make install':

  % ./configure                         # run the configure script
  % make                                # build the interpreter and the library

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

  [ Become root if necessary ]
  % make uninstall                      # remove everything

For more detailed instructions and for information about specific platforms 
see the Misc/INSTALL file.


What's Iguana anyway?
---------------------

Iguana is an interpreted, interactive, high-level language, primarily intended
for numerical computations. Iguana can be extended with your own modules 
written in C or C++ and it is also adaptable as an extension language for 
existing applications.


Features
--------

  o  interactive nature
  o  simple and clear syntax
  o  interpreted language
  o  very fast edit/run cycle; no compile or link steps needed
  o  automatic memory allocation/deallocation 
  o  no type declarations 
  o  exceptions (not in the language, yet) 
  o  dynamic loaded modules
  o  extendible 
  o  embeddable
  o  programs can construct and execute Iguana code using C strings
  o  ANSI C implementation
  o  GPL license


How do I learn Iguana?
----------------------

All documentation is provided in this distribution as LaTeX sources (LyX 
output). The LaTeX version is primarily intended for documentation authors, 
translators, and people with special formatting requirements (PDF, DVI, etc). 

To build the HTML documentation follow the instructions in the Doc/README file.


Iguana website
--------------

The URL of the Iguana website is:        
	
	http://web.tiscali.it/iguana.lang


Distribution structure
----------------------

Most subdirectories have their own README files. Most files have comments.

Build/                  Helper directory for configure script
Demo/                   Demonstration C programs, Iguana scripts
Doc/                    Documentation sources (LaTeX)
Iguana/                 The interpreter
Include/                The C API interface
Misc/                   Other text files and miscellaneous useful files
Modules/                Implementation of the dynamic loaded modules
Objects/                Implementation of the builtin objects
Parser/                 The parser and the tokenizer
Tests/                  The test suite (incomplete)

LICENSE                 Licensing information
README                  The top-level README file
aclocal.m4              autoconf m4 macros
Makefile.in             Source from which configure script creates the Makefile
config.h.in             Configuration header (GNU autoheader output)
configure               Configuration shell script (GNU autoconf output)
configure.ac            Configuration shell script (GNU autoconf input)

The following files will be created in the top-level directory by the
configuration and build processes:

Makefile                Build rules
buildno                 Keeps track of the build number
config.h                Configuration header
config.log              Log from last configure run
config.cache            Cache of configuration variables
config.status           Status from last run of the configure script
libiguana.a             The static version of the library
libtool                 Provide generalized library-building support services
iguana                  The executable interpreter
tags                    Vim tags file (`make tags' output)
TAGS                    Emacs tags file (`make TAGS' output)


Developers
----------

If you want to hack on this code, a list of known bugs and to-do items
can be found in the file Misc/PLAN.

Developers will find additional documentation for Iguana interfaces in the
form of header file comments in the Include/ directory. There is also an
hacking document (Misc/HACKING) that should help developers to find their
way through Iguana's architecture.


Author
------

Iguana was originally written by Davide Angelocola. See also Misc/THANKS for 
a list of contributors.


Contact Information
-------------------

Snail-mail:
  Davide Angelocola
  Via Sandro Pertini, 4
  Cave (Roma), CAP 00033
  Italia

Email:
  davide.angelocola@tiscali.it

URL: 
  http://web.tiscali.it/iguana.lang/davide.html

That's all folks! 
-- Davide 
