-------------------------------------------------------------------------------
Holsham Traders README
-------------------------------------------------------------------------------

Info
----

Holsham Traders is a realtime multiplayer trading game. You are a trader in
a town named Holsham, which is situated on a distant planet; You send
your transporters from town to town and try to make as much money as
possible by buying and selling goods.

htsserver is the server application of Holsham Traders.

It should work on GNU/Linux, SunOS, FreeBSD and HP/UX.  


Release Notes
-------------

This is still a developer release. You cannot play the game, yet.

From now on, you need at least GLib 1.3.2 to be able to compile htsserver.

You should remove all files from previous installations, especially the whole
directory ~/.htsserver, because we don't use it anymore.

This release won't work with ghtsclient 0.2 and nhtsclient 0.5.1.
Please upgrade.


Requirements
------------

 * GLib 1.3.2 or better:
    ftp://ftp.gtk.org/pub/gtk/v1.3/


Compiling and Installing
------------------------

 * Install GLib 1.3.x
    * Extract the GLib archive
    * Run ./configure with the --prefix=<PREFIX> argument, so you needn't
      replace your stable GLib 1.2.x with the beta stage GLib 1.3.x!
      The 1.3.x series is incompatible with the 1.2.x series, therefore
      your other applications wouldn't run/compile anymore.
    * make
    * make install

 * Add <PREFIX>/lib to the environment variable LD_LIBRARY_PATH:

     export LD_LIBRARY_PATH=<PREFIX>/lib

   Alternatively you can add <PREFIX>/lib to your global /etc/ld.so.conf and
   run ldconfig, but you need root permissions for this.

 * Set the environment-variable GLIB_CONFIG to <PREFIX>/bin/glib-config-2.0:

     export GLIB_CONFIG=<PREFIX>/bin/glib-config-2.0

   Alternatively, you can create a symbolic link <PREFIX>/bin/glib-config,
   which points to <PREFIX>/bin/glib-config-2.0:

     ln -s <PREFIX>/bin/glib-config-2.0 <PREFIX>/bin/glib-config

   This is necessary, because configure only searches for glib-config
   and *not* for glib-config-2.0 by default.

 * Install htsserver
    * Extract the htsserver archive
    * Edit src/defaults.h to set some compile-time options. (optional)
    * ./configure --help                 (to see the options you have)
    * ./configure --with-glib-prefix=<PREFIX>
    * make
    * make install


See INSTALL for more information.

If you have problems compiling, please send a bug-report.


Quickstart
----------

 * Edit the configfile. You need to at least change the adminpassword, because
   htsserver will *not* start with the default adminpassword.
 * Start htsserver.
 * Run a client (see below) and connect to htsserver.


Clients
-------

I know of two clients for Holsham Traders at the moment:

nhtsclient
 * ncurses-based client, written by me
 * Homepage: http://nhtsclient.sourceforge.net/

ghtsclient
 * client for Gtk+, written by Piotr Esden-Tempski <pe1724@bingo-ev.de>
 * Homepage: http://ghtsclient.sourceforge.net/


License
-------

htsserver - the server application for the trading game Holsham Traders
Copyright (C) 1998-2001 Uwe Hermann

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; either version 2 of the License, or
(at your option) any later version.

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
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

See COPYING for details.


Mailinglists
------------

There are two mailing-lists at the moment:

 * htsserver-devel:

   Mailing-list for use by developers and contributors.

   http://lists.sourceforge.net/mailman/listinfo/htsserver-devel

 * htsserver-cvs:

   Information about every commit to the CVS-repository is automatically
   sent to this list. It should not be used for discussions. Its purpose
   is to keep you up-to-date with current development.

   http://lists.sourceforge.net/mailman/listinfo/htsserver-cvs


Homepage
--------

The official Holsham Traders homepage is:
 http://htsserver.sourceforge.net/

You should also check the Holsham Traders project-page on SourceForge:
 http://sourceforge.net/projects/htsserver/

-- 
Uwe Hermann <uh1763@hermann-uwe.de> 
