  The Capitalist Handbook
  Daniel Hermann hoermen@users.sourceforge.net
  Version 0.3.1 , Mon Apr 7 02:21:38 CEST 2008

  This Handbook describes Capitalist Version 0.3.1.
  ______________________________________________________________________

  Table of Contents


  1. Introduction
     1.1 Changes
        1.1.1 v0.1
        1.1.2 v0.2
        1.1.3 v0.2.1
        1.1.4 v0.3
        1.1.5 v0.3.1

  2. Installation
     2.1 How to obtain Capitalist
     2.2 Requirements
        2.2.1 Server
        2.2.2 Client
     2.3 Compilation and installation

  3. Usage
     3.1 Starting the server
     3.2 Starting the clients
     3.3 Starting the game

  4. Questions and Answers
  5. Copyright
  6. Additional Information, Clients


  ______________________________________________________________________

  11..  IInnttrroodduuccttiioonn

  Capitalist is a Monopoly(R)-like board game for 2-8 players. Walk
  around the board, buy properties, receive rent from your competitors,
  try to get monopolies to build houses and hotels on them and finally
  be the richest on the board.

  Capitalist is server-based and can be played over the internet. This
  handbook describes the server.


  11..11..  CChhaannggeess

  11..11..11..  vv00..11


  +o  Initial Release


  11..11..22..  vv00..22


  +o  debts

  +o  bankruptcy

  +o  allow animations for moving the token on client


  +o  (list incomplete)


  11..11..33..  vv00..22..11


  +o  minor updates for gcc-3.x compatibility


  11..11..44..  vv00..33


  +o  enable server to be started by client

  +o  added settings framework: new commands "set" and "show", only one
     option yet ("aifill")

  +o  corrected implementation of income tax (depending on properties of
     player)

  +o  corrected jail card handling (removal from stack, registration with
     player)

  +o  AI player: limited functionality, no trading yet, command
     "aitoggle" and option "aifill"

  +o  Bugfixes


  11..11..55..  vv00..33..11


  +o  bugfix release (compile issues with gcc-4.3 and on freebsd 6.3)

  +o  added man page


  22..  IInnssttaallllaattiioonn

  22..11..  HHooww ttoo oobbttaaiinn CCaappiittaalliisstt

  You can download the latest version of Capitalist at

       <http://capitalist.sourceforge.net/>.



  22..22..  RReeqquuiirreemmeennttss

  22..22..11..  SSeerrvveerr

  There are no special requirements. It currently compiles only on linux
  (AFAIK), but there should not be huge problems to port it to any other
  UNIX operating system. Feel free to try it and send me your patches.


  22..22..22..  CClliieenntt

  The client (Kapitalist) requires the following libraries/headers to
  compile and run:

  +o  KDE 3.x (tested on KDE >=3.3.2)

  +o  Qt 3.x (tested on Qt >=3.3.4)

     Install appropriate packages for your distribution or visit
     <http://www.kde.org>.


  22..33..  CCoommppiillaattiioonn aanndd iinnssttaallllaattiioonn

  In order to compile and install Capitalist on your system, type the
  following in the base directory of the Capitalist distribution:


       % ./configure
       % make
       % make install



  Since Capitalist uses autoconf you should have no trouble compiling
  it. Should you run into problems please report them to the author
  <mailto:hoermen@users.sourceforge.net>.



  33..  UUssaaggee

  33..11..  SSttaarrttiinngg tthhee sseerrvveerr

  Capitalist is server-based, so at first you have to start the server
  on a console with the command


       % capitalist



  which opens up a special server console with a prompt,


       This is the server for Capitalist version x.x
       Get more info at http://capitalist.sourceforge.net/

       1: Now accepting new client connections

       Get a list of the available commands with 'help'.
       > _



  where you can type in commands like


       > help
       Available commands: (P=player, L=level, O=option V=value)
       -------------------------------------------------------------------
       help            - this help text
       quit            - quit game and shutdown server
       list            - list players
       show            - show available server options
       set O V         - set server option X to value V
       start           - start game
       ...
       Abbreviations are allowed.
       > _

  or see a list of options with


       > show
       -------------------------------------------------------------------
       + means you may change the option
       = means the option is on its default value
       -------------------------------------------------------------------
       Option        value   (min,max)      description
       -------------------------------------------------------------------
       aifill        +=2     (2,8)
       -------------------------------------------------------------------
       > _



  33..22..  SSttaarrttiinngg tthhee cclliieennttss

  In the next step, each player who wants to play in the game should
  join the game by starting a client (i.e. Kapitalist) and connecting to
  the server. When a game is in progress, there is one server running,
  and as many clients as there are human players.


  So each player types


       % kapitalist



  on the commandline (or starts Kapitalist in the K-Menu) and connects
  by selecting Game->Connect. A Dialog appears where you must type in
  the correct hostname and port of the server (in many cases, the
  default, localhost:2525, is already ok). In addition you have to chose
  a suitable nickname.


  33..33..  SSttaarrttiinngg tthhee ggaammee

  When all human players have connected to the server, the game can be
  started by typing


       > start



  on the server console. AI players are created automatically by the
  server up to a number of "aifill" total players. By default, aifill is
  set to 2, so that you play against one AI opponent if there are no
  other human players connected at starting time.

  Now most of the action takes place in the client windows. Please
  consider the client documentation for more information.


  44..  QQuueessttiioonnss aanndd AAnnsswweerrss



     EErrrroorr:: bind failed: address already in use
        You have to use a different port. The default port is 2525. You
        can tell the server to use a different port by giving '--port'
        as a command line argument:


          % capitalist --port 3456



     You can get a list of other available command line arguments by
     typing


          % capitalist --help



  55..  CCooppyyrriigghhtt

  Capitalist Copyright 2006,2008 Daniel Hermann,
  hoermen@users.sourceforge.net

  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., 675 Mass Ave, Cambridge, MA 02139, USA.



  66..  AAddddiittiioonnaall IInnffoorrmmaattiioonn,, CClliieennttss

  For additional information see the Capitalist Homepage
  <http://capitalist.sourceforge.net/>.


  This linuxdoc documentation was processed in the following way:


       % linuxdoc --backend=html index.sgml   -> capitalist/docs/en/*.html
       % linuxdoc --backend=txt index.sgml    -> README



