Adonthell 0.3 
                           

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    COPYING file for more details.



Installation:
=============

See the INSTALL and NEWBIE files for details.

Note that this package alone doesn't allow you to play anything - 
you'll need a game package in addition to this one. The official
game package for this release is Waste's Edge release 0.3. If you
don't already have it, you should download it and install it next to
this package.


Configuring Adonthell:
======================

The first time you run Adonthell, a configuration file is created:
$HOME/.adonthell/adonthellrc. Edit it to customise the game to your
convenience.

The available options and what they do are:

- Screen-mode
  Whether Adonthell should run fullscreen or in windowed mode 
  0 = Windowed mode, 1 = Fullscreen mode
  
  (If you have trouble with the fullscreen mode, refer to the 
  FULLSCREEN.howto file for help)

- Double-size
  Whether resolution should be scaled to 640x480 or not
  0 = disable, 1 = enable
  
  Enabling double-size mode significantly increases CPU usage. On
  old hardware you should consider turning this option off and run
  Adonthell in fullscreen mode instead.

- Language [locale]
  Specifies which language to use. As long as this option is unset,
  the language is determined by one of the following environment
  variables: LANG, LC_ALL or LC_MESSAGES. Once the option is set,
  it overrides any environment variable. For a listing of valid
  locale strings, run 'locale -a'.
  
  Of course, the game you run has to provide the translation you 
  chose here, otherwise you'll get the default (i.e. English) text.
  Languages available in this package:

  Language    Locale
  ------------------
  Dutch       nl_NL
  English
  French      fr_FR
  Italian     it_IT

  If new languages become available, they will be announced on
  our website: http://adonthell.linuxgames.com/

- Font [font.ttf]
  Chose a true type font to use for displaying text. 
  
  If the default font doesn't suit you, or if it does not contain
  the glyphs required by the Language you selected, you can specify
  a different font here. Either enter an absolute path to a font
  file in true type format or enter the font name and copy the font
  into <gamedatadir>/gfx/window/font/ .

- Quick-load
  Whether the last saved game should be automatically continued at
  startup. Only works if at least one saved game exists.
  0 = disable, 1 = enable

- Audio-channels
  Whether sound should be mono or stereo
  0 = Mono, 1 = Stereo

- Audio-resolution
  Whether audio output should be 8 or 16 bit
  0 = 8 bit, 1 = 16 bit

- Audio-sample-rate
  0 = 11025 Hz, 1 = 22050 Hz, 2 = 44100 Hz

- Audio-volume
  The mixer setting, 0 - 100 %
  
  (Note that a value of 0 will turn audio completely off)


Running Adonthell:
==================

Okay, now you're ready to launch the program. Type

$> adonthell <gamename>

to run the game named <gamename>. To get a list of currently 
installed games you can play, type:

$> adonthell -l

This will print a list of the installed games you can launch
with above command.

For further information on how to play Adonthell, please refer to the
PLAYING file that comes with the game data.


Directories:
============

- $HOME/.adonthell 
  contains the configuration file and your saved games.

- Global data directory
  You can get this directory by invoking 'adonthell -d' (by default
  /usr/local/share/adonthell). This is the directory where games will
  install to. If you have a game installed somewhere else, you can
  play it by invoking 'adonthell -g </full/path/to/my/game>'


Release Notes:
==============

The main purpose of this release is to attract new programmers, 
artists and writers in order to shorten the time until the next 
version.  So if you have experience in C++ (and optionally Python), 
or if you are good at computer graphics or writing we would like to
hear from you.  Please have a look at our development site 
  
  http://adonthell.linuxgames.com/development/

for further details.

Adonthell - Waste's Edge -, or v0.3 for short is no complete RPG.
As the v0.3 implies, the engine is far from being finished, although
it should be free of severe bugs.  Missing features include combat, 
items and magic.  But you can interact with NPC's and the game world, 
and the internals enable us to create a basic plot, so v0.3 is actually
playable!

You're greatly invited to report us bugs, problems, or anything you
think we should know. Any feedback is appreciated, so don't hesitate!


Contact:
========

You can reach us in various ways:

Email:         adonthell-project@linuxgames.com
Mailing list:  adonthell-general@nongnu.org
Web site:      http://adonthell.linuxgames.com
Tech support:  http://savannah.nongnu.org/support/?group_id=702

There is a Message Board for user to user discussion at
    http://www.3dforums.com/?action=forumpage&loc=49&forum_id=158

If you want to rate or comment on Adonthell, feel free to do so at
    http://www.happypenguin.org/show?Adonthell
    http://www.freshmeat.net/projects/adonthell


Reporting Bugs:
===============

We hope you'll never have to, but if you discover a problem, we
would like to hear about it. Please use the Development mailing list
(adonthell-devel@nongnu.org) for that. You can find informations on
this and other mailing lists at 

    http://adonthell.linuxgames.com/contact/mailinglist.shtml


Thank you for trying this software.
- The Adonthell team.