$Id: README,v 1.34 2003/09/05 17:11:53 sphair Exp $

Welcome
-------

Welcome to ClanLib, a multi-platform game development library.


Getting started
---------------
PLEASE! Please read the INSTALL files for the platform/compiler you want to use.
See INSTALL.win32, INSTALL.linux, INSTALL.borland, INSTALL.whatever.


Upgrading from earlier ClanLib versions
---------------------------------------
If you are upgrading your ClanLib project from earlier ClanLib versions, read the
file README.upgrade for API changes. The NEWS file will have some details on
what was upgraded, fixed and added in this specific version.


Documentation
-------------
If you get any problems, there is a FAQ in the Documentation folder; it might have
an answer to your questions. Otherwise, read the overviews for specific info on
the various areas of ClanLib. 

  Examples: Many small examples showing features of ClanLib.
  Documentation/Overview: Articles about certain features of ClanLib.
  Documentation/Reference: The complete API reference to all ClanLib classes.
  Documentation/Tutorial: Some tutorials about game programming with ClanLib.
  Documentation/FAQ: Frequently asked/answered questions.

YOU ARE NOT SUPPOSED TO READ THE XML FILES, THEY MUST BE CONVERTED TO HTML!
(OR JUST READ THEM ONLINE ON CLANLIB.ORG)

If you are using Windows, and haven't got the tools required to build the
documentation, or the distribution of ClanLib you have don't have a Documentation
folder, you can manually download the documentation packages from
http://clanlib.org/download.html. Also, all documentation is available
for viewing online at http://clanlib.org/docs.html
 

Mailing lists
-------------
You can subscribe to our mailing lists, either by visiting the website
at http://clanlib.org/mailinglist.html, or do it manually by sending
mails as described below.

You can subscribe to the ClanLib mailing lists by sending a mail to:
	clanlib-user-subscribe@clanlib.org
	clanlib-devel-subscribe@clanlib.org
You can then afterwards send mail to:
	clanlib-user@clanlib.org
	clanlib-devel@clanlib.org
If you want to unsubcribe at any time, just send a mail to:
	clanlib-user-unsubscribe@clanlib.org
	clanlib-devel-unsubscribe@clanlib.org

We also have digest versions of the lists, the email addresses there are:
	clanlib-user-digest-subscribe@clanlib.org
	clanlib-user-digest-unsubscribe@clanlib.org
	clanlib-devel-digest-subscribe@clanlib.org
	clanlib-devel-digest-unsubscribe@clanlib.org

We also have a CVS commit message mailing list:
	clanlib-cvs@clanlib.org.

Everytime anything is commited to cvs, it will be posted on that list. This
is very useful for people that want to follow cvs development very closely.
To subscribe, send a mail to:
	clanlib-cvs-subscribe@clanlib.org
To unsubscribe:
	clanlib-cvs-unsubscribe@clanlib.org


Making ClanLib even better
--------------------------
We are grateful for all the help we can get, and if you wish to contribute with
anything, don't hesitate to contact us.

If you have fixed something in ClanLib, you can send us a patch. Please have a
look at the PATCHES file for more detailed information.

A developer's reference is available. This contains all the internal classes for 
ClanLib which are useful for ClanLib developers.  To enable the reference, go in
to the Documentation/Reference directory and run 'make dev_ref'. Note that you
need the same tools as described in the section Documentation to make this.


ClanLib Website
---------------
Check out ClanLib homepage at:

	http://www.clanlib.org

Here you will find:
- News about ClanLib development
- Downloads of ClanLib and other required/optional libraries
- Documentation
- Links to ClanLib games
- Much more!

--
Enjoy,
The ClanLib development team
