Notes on compiling xpat2:
=========================

With xpat2, you have to select a number of options at compile-time.

1) Front end.
   Currently, there are front-ends for Xlib, Athena widgets, and Motif.
   To select one, set the variables KIT_OPTION and KIT_LIBS in the Makefile.
   Xlib: this is here to support compatibility with xpat version 1.
   Xaw:  this is the ``standard version''. With the Athena widget interface,
	 you may customize the button labels for internationalisation.
   Xm:   The Motif interface was a short try (``This should be easy...''),
	 but is currently not supported. Some time later perhaps.

2) Card drawing routine:
   Currently, there are two possiblities:
   - the card drawing routine from xpat1, with internal bitmaps for a
     standalone binary.
     - You may select the xpm option (=> Makefile), in this case you may
       load images of complete colour cards named (rank).(suit).xpm.
     - You may select the LOADCARDS option (=> Makefile, LOAD_OPTION), which
       permits you to load lower resolution bitmaps for the cards.
   - the new card construction routine, WHICH REQUIRES XPM.
     With this routine (which has longer startup times, beware!), you
     may use cards with antialiased rank and suit symbols. An extended
     ``Cards.conf'' file (the format is explained in X-gfx2.c) allows you
     to customise you appearance of the cards. Optional backgrounds may
     be used to add water marks to the cards (by default, the X logo is pasted
     into the cards of rank 2..10).
   To select one of these, make a symbolic link from X-gfx.c to either
   X-gfx1.c or X-gfx2.c.

3) Sound.
   As sound is only a gimmick, this is not so important.
   Select one of
   - no sound
   - FM sound (Linux only, requires instruments to be loaded into the kernel
     before use)
   - digitized sound (Suns, Linux) requires some .au files installed in
     /usr/games/lib/xpat/audio
   in the Makefile (SOUND_OPTION)

4) Round cards option.
   For quicker drawings, (but ugly cards, similar to those used in DOS and
   MS-Windows games) define NO_ROUND_CARDS in the Makefile.

5) Warning Level (not a game option)
   The Makefile by default turns on many warning (for development).
   Under Linux, xpat2 compiles without warnings, except
   - when using xpm (one warning about omitting 'const', that's OK)
   - when using Xaw (TONS of warnings about omitting 'const')
   No other warnings should appear.
   With other systems, which usually have `dirty' include files, you may get
   more (or different) warnings. Just throw away the warning flags in this
   case.

6) Directories
   Two directory/file names are compiled into the game:
   - the root of the xpat2 data directory tree (LIBDIR), which is
     /usr/games/lib/xpat by default. Some people may like to insert a 'local'
     here, or make the path relative to their HOME directory.
   - the name of a log file for successfully solved games. This is
     /var/games/xpat.log by default. Another possible location (for
     systems with read-write mounted /usr filesystem) would be
     $(LIBDIR)/xpat.log.


To compile:
===========

- check the symlink X-gfx.c
- Select a Makefile
- edit the Makefile (Sorry, no Imakefile yet)
- type 'make'

To install:
===========
- type 'make install' (as root)