Provided by: xgammon_0.99.1128-3_i386 bug

NAME

       xgammon - an X11 backgammon for linux

SYNOPSIS

       xgammon [-otherdisplay <displayname>]
               [-boardgeometry <geometry_string>]
               [-boardcolor    <color>] [-bc <color>]
               [-darkcolor     <color>] [-dc <color>]
               [-lightcolor    <color>] [-lc <color>]
               [-barcolor      <color>] [-b  <color>]
               [-whitecolor    <color>] [-blackcolor <color>]
               [-doublerfont   <font>]  [-smallFont <font>]
               [-doubling      +doubling]
               [-watchmove     +wachmove]
               [-stonesteps    <pixel>]
               [-delaytime     <tsec>]
               [-buttonmove    +buttonmove]
               [-bm            +bm]
               [-autoplay      +autoplay]
               [-rollout       +rollout]
               [-nr   <number_of_rollouts>]
               [-f    <filename>]
               [-h    (black|white)]
               [-gamekind -g   (hvc|cvc|hvh)]
               [-winat         <points>]
               [-? -help]

DESCRIPTION

xgammon’, a backgammon program for linux

OPTIONS

       xgammon recognizes the following options:

       -otherdisplay <displayname>
              Play  a  game with a player on some remote X-Terminal.  A second
              ‘xgammon’   will   be   displayed   there.   (example:   xgammon
              -otherdisplay somehost:0.0)

       -boardgeometry <geometry_string>
              Defines  the size of the board widget. ‘Geometry_string’ must be
              an XtGeometry-string (example: 450x350). By default the relation
              of  width/height  of  the  board  is 12/15. <Geometry_string> is
              rounded to this relation.

       -boardcolor, -bc <color>
              Sets the background color of the board.

       -darkcolor, -dc <color>
              Sets the color of dark points.

       -lightcolor, -lc <color>
              Sets the color of light points.

       -barcolor, -b <color>
              Sets the color of the bar and the left and  right  edge  of  the
              board.

       -whitecolor, -blackcolor <color>
              Sets the color of the stones.

       -humancolor, -h (black|white)
              Sets  the  color  of  the human player’s stones.  Implies a game
              between ‘xgammon’ and a human being. (The default).

       -doublerfont <font>, -smallFont <font>
              These are the fonts used for the doubler dice.  Only  one  large
              and one small font can be selected now, not a font family yet.

       -gamekind, -g (cvc|hvc|hvh)
              Sets the game.
              cvc means computer versus computer,
              hvc means human    versus computer,
              hvh means human    versus human,

       -winat <points>
              Play a tournament up to <points> points.

       -watchmove, +watchmove
              ‘xgammon’ will "move" it’s stones.

       -stonesteps <pixel>
              You  can  speed  up the stones by giving this resource a greater
              value.  Implies watchmove is set ‘true’.

       -delaytime (tseconds)
              Sets a delaytime in tenth of a second, which gives you a  closer
              look on the computer moves.  Implies watchmove is set ‘false’.

       -buttonmove -mb, +buttonmove +bm
              If buttonmove is true, you can set the stones simply by pressing
              the button.  The left button sets  the  lower  dice  value,  the
              right  one  the  other.  In case of equation both buttons can be
              used.

       -autoplay, +autoplay
              ‘Xgammon’ will set your stones, if there is  only  one  possible
              move.

       -doubling, +doubling
              Sets  the  use  of  the  doubler  dice.   Since  the doubling of
              ‘xgammon’ is still poor, you might wish to turn it off.

       -rollout, +rollout
              ‘Xgammon’ will rollout a position. This rank   is  read  from  a
              file.   (See  -f  option  below.)  This  file  is  automatically
              generated from the current game, if not specified otherwise.

       -nr <number_of_rollouts>
              Sets the number of rollouts.

       -f <filename>
              Specifies the positionfile you  want  to  use.  The  default  is
              ‘xgammon.save’.

       -database <filename>
              Specifies the endgame database file to use.

HOW TO PLAY

       When  you  start  the game, ‘xgammon’ will immediately roll and start a
       game. When it’s your turn:
       Move pointer to a stone.
       Press left button.
       Carry stone to the chosen point.
       Release button.
       That’s it.
       To speed this a little up, try the +buttonmove  option  or  .buttonmove
       resource. (See RESOURCES or OPTIONS.)

DOUBLING

       When  you’re  allowed  to  double, ‘xgammon’ draws empty dice.  You can
       double by a single click on the doubler dice or press the ‘d’ key.
       Some simple popups manage the rest.
       This is only possible, when the ‘doubling’  resource  is  ‘true’.  (See
       RESOURCES or OPTIONS.)

GAME OPTIONS

       There  are  three different kind of games. Human versus human, computer
       versus human, and computer versus computer. The  last  one  isn’t  very
       meaningful yet, and more or less for reasons of development.

MENU OPTIONS

       [edit position]
              If  you click on this menu entry, ‘xgammon’ will first break the
              current game or tournament and draw an empty board. Then you can
              enter  a  position to your liking.  The right button gives you a
              black stone, the left button a white stone.  The  middle  button
              removes  a  stone.   If there are 15 stones of each color on the
              board ‘xgammon’ will automatically ask  you  for  the  dice  and
              doubler  etc. in a popup.  In case of stones already beared off,
              you can break the setting of stones by hitting any key.   Choose
              ‘ok’  button and the game continues.  You can as well rollout or
              maildump  this  position.   (For  this  purpose  set  the  right
              gamekind first.)

       [computer finish]
              If  the  game  is  almost done and you are bored with rolling it
              down, you can click this option and the computer will finish the
              game.  At  the  end  of  the  game the human player gets control
              again.
              In this mode the computer will not double.

       [rollout]
              To rollout a position use this  option.   The  number  of  games
              rolled  out  are  set with the ‘numrollouts’ resource or the -nr
              command line option.  (see RESOURCES or OPTIONS.)  Invoked  from
              the  game  ‘xgammon’  will fork itself and start a second, third
              ... process, so you can continue playing.  There will be a popup
              to  inform  you  about  the  current state and the result.  This
              popup will vanish with any button  or  key  event  inside.   The
              result   of   the   rollout   is   additionally   saved   in   a
              ‘xgammon.rollout.<num>.save’ file.  It is  more  appropriate  to
              use  this feature via commandline options.  (See ROLLOUT below.)

       [mail dump]
              Saves the current or an edited position in the  format  used  by
              FIBS  or  in  ‘rec.games.backgammon’  newsgroup  in a file named
              ‘xgammon.maildump’.

KEYS

       The board reacts on the following keys:
       ‘q’, ‘<Ctrl>c’ or ‘<Ctrl>d’ quit the game.
       ‘u’ undoes the current move move.
       ‘r’ restarts the game (tournament).
       ‘s’, ‘S’, ‘l’ and ‘L’ save or load a position or game.
       You may set these keys in your .Xdefaults file.

TEXT WINDOWS

       There are two text windows in the ‘XGammon-Buttons’ window,  where  the
       current  tournament,  moves,  doubler actions etc. are printed. You can
       also add comments there.  The text in the lower window will be saved if
       you invoke any save command.

EDIT A POSITION

       You may edit a position, and play out from there, by pressing the ‘edit
       position’ menu entry in the ‘game’ menu.  Black  stones  are  set  with
       left  mouse button, white stones with the right one.  If you misplace a
       stone you can remove it with the middle button.  There will be a  popup
       asking  for additional information, if you have entered 15 black and 15
       white stones, or pressed any key to stop placing stones.

MAIL DUMP A POSITION

       Clicking the menu entry ‘mail dump’ ‘xgammon’  will  save  the  current
       position  in  a  file named ‘xgammon.maildump’.  The occuring format is
       that used most often  in  ‘rec.games.backgammon’  news  group.   So  it
       should be very easy to edit a position, add some comments and then mail
       or post it.

ROLLOUTS

       Even if there is the menu option ‘rollout’, this  is  more  or  less  a
       command line option.  An example would be
       ‘xgammon -rollout -nr 1000 -doubling -f rollout.save’,
       which  would rollout a 1000 times the position saved in ‘rollout.save’.
       It should be rather easy to modify the save  file  slightly,  and  make
       several  rollouts  of  these positions. All results will be appended to
       these files. If you use the menu entry ‘rollout’, it is most  important
       to  set an appropriate ‘numrollouts’ resource in your ‘.Xdefault’ file,
       because ‘xgammon’ will not  ask  you  for  this  value,  when  starting
       rollouts.

X RESOURCES

       .otherdisplay: <displayname>
              Play  a  game with a player on some remote X-Terminal.  A second
              ‘xgammon’   will   be   displayed   there.   (example:   xgammon
              -otherdisplay somehost:0.0)

       .boardColor: <color>
              Specifies the background color of the board.

       .lightColor: <color>
              Specifies the background color of the lighter points.

       .darkColor: <color>
              Specifies the background color of the darker points.

       .barColor: <color>
              Specifies the color of the bar and the board borders.

       .whiteColor: <color>
              Specifies the color of the "white" stones.

       .blackColor: <color>
              Specifies the color of the "black" stones.

       .doublerFont: <font>, .smallFont: <font>
              Defines  the  fonts used for doubler dice. The doubler dice size
              depends on the board size. If the board size is too  small,  the
              smallFont will be used.

       *board.cursor: <cursor>
              Sets the cursor to be used for the board widget(s).

       .humanStones: <black|white>
              If  you  want  to  play  the  white  stones set this resource to
              "white". ("Black" is Default.)

       .watchmove: <true|false>
              If watchmove is true, you can see the  stones  "fly",  when  the
              computer moves.

       .delaytime: <seconds>
              Sets  a delaytime in tenth of a second, which gives you a closer
              look on the computer moves.  Implies watchmove is set ‘false’.

       .stonesteps: <pixel>
              You can speed up the stones by giving this  resource  a  greater
              value.  Implies watchmove is ‘true’.

       .doubling: <true|false>
              Sets  the  use  of  doubler  dice.   Since  the  doubling of the
              computer is still poor, you might wish to turn it off.

       .buttonMove: <true|false>
              If buttonmove is true, you can play by simply pressing a button.
              The  left  button  sets  the lower dice value, the right one the
              other.  On equation both buttons can be used.

       .numrollouts: <number>
              Specifies the number of rollouts from a given  position,  before
              adding the result to a position file. Any unsigned integer value
              should be all right.

       .positionfile: <name>
              The file, where ‘xgammon’ shall save and load  all  informations
              to-and-fro.

DIAGNOSTICS

       ‘Xgammon’  uses  the  function  usleep()  for delaytime.  Usleep is not
       defined on some systems.
       #define usleep(a) sleep(a)
       is set then.  As a result, you can only delay seconds, not tseconds.

BUGS

       The program is still in state of development, so  there  are  certainly
       bugs.  ‘Xgammon’ will save the current position in a ‘xgammon.sig_save’
       file on some signals. Please email this file to the  authors.   It  may
       help  find  the  bugs.  If you can generate a core dump, gzip, uuencode
       and mail it, which would also be very helpful.

       Otherdisplay:
       Some popup resources and actions on ".otherdisplay" sometimes get lost.
       Black can set white stones and vv. (funny feature ?)

AUTHORS

       Lambert Klasen and Detlef Steuer
       email:
       klasen@asterix.uni-muenster.de steuer@amadeus.statistik.uni-dortmund.de