


                          INSTALLATION OF YAMSWEEPER


1.  Environment

1.1  Version 1.9

  Version 1.9 of Yamsweeper has been tested on:

   o  Linux 1.00 (Slackware) + JE2 + XFree86 2.0/(S3 801)
             AT Compatible, 486DX/50

   o AT&T Unix System V Release 4 Version 3.0 / 386
      w/ X Window System Version 11 Release 5

   o AIX 3.2 + X11R5

   o BSD/386 1.1 (X11R6)

   o SunOS 4.1.{1,2}(X11R5/6)

   o Solaris2.{1,2}(X11R6)

   o DEC5000/133+Ultrix4.3+X11R6+gcc-2.6.0

   o Sun SS-5, SunOS 4.1.3_U1 + gcc-2.5.8 + X11R6PL5

   o Sun SS1, IPX, SunOS 4.1.1, SunOS 4.1.3+JLE +X11R5PL8

   o OMRON SX-9100, UNIOS-B V1.6 + gcc-2.5.8 + X11R5PL8

  Yamsweeper 1.9 was developed on Linux.

  Special Thanks to testers:
      nakao@insux1.ins.u-tokyo.ac.jp
      tika@zeus.lsi-j.co.jp
      tomoaki@tom.mat.flab.fujitsu.co.jp

1.2  Prior Versions

  The prior version of Yamsweeper had been tested on:

   o PANIX Ver 3.0 (SVR4.0.4)

   o 386BSD

   o Sun OS 4.1.1-JLE
      w/ X Window System Version 11 Release 4

   o UNOS 9.1 or later
      w/ UN/X Window Release 4.x

   o DEC5000/133+Ultrix4.3

   o Sun3/260C Sun UNIX 4.2 Release 3.5EXPORT X11R4

   o Fujitsu Sun4/330 Frame buffer CG9
      SunOS4.1.2 JLE 1.1.2   X11R5 patch 17 + Xsun24 patch



2.  How to build yamsweeper -- ordinary make

  The procedure goes like the following:

       configure -> make -> su somebody -> make install


2.1  sh configure

  "Configure" script is provided to build an Imakefile and a Makefile. It will
  ask some questions. Just type return if you don't know the answer.

  If you are using EUC (Enhanced UNIX code) as kanji chanracters,  you may  be
  able to use configure.euc instead of configuere.

  Configure asks if you use FD_SET macros defined in yamsweeper sources. First
  try  "no"  to  the  question.  If  make  fails due to the lack of FD_* macro
  definition, then try "yes."

  Linux users are treated exceptionally, this question is omitted.

  If you want to keep high scores,  answer "yes" to "high scoring?"  question.
  You  can  also  speicify  the  location  of  the high-score file. I strongly
  recommend that you should make a  special  user  such  as  'game',   to  own
  high-score  file,   although  the  score  file  is ciphered. High-scoring is
  enabled by default. You can specify the location of the high-score file. The
  high-score file is encrypted, not a plain text.

  Configure generates Imakefile according to your answers,  from  "imake.src."
  It  also invokes xmkmf to create Makefile. Makefile privided with Yamsweeper
  distribution is generated under the author's environment, and cannot be used
  generically. Use this merely as a reference for  environments  that  do  not
  have xmkmf. "Make depend" after configure is recommended.

2.2  make

  Once  you  did  configure,  just type "make." This creates Yamsweeper's load
  module.

  If your compiler fails  to  make,   try  again  with  another  configuration
  parameters.  e.g.  If  your  linker  complains that it cannot find random in
  system libraries, answer "no" to the question "has random() ?"

  If 'make' command came with your system fails to build yamsweeper, try GNU's
  gmake. For instance, NEWS-OS Release 4.1R appeared to have some difficulties
  in making yamsweeper. Gmake fixed this problem.


2.3  Check that Yamsweeper is properly made

  Play it ! (^_^)

2.4  make install

  If you selected high-scoring, you should make a special user such as "game",
  who owns the high score file. Do "make install" as that user. "Make install.
  man" installs man pages.

       $ su game
       # make install
       # make install.man
       # exit
       $


  That's it. Yamsweeper should have been installed properly to  the  directory
  you selected, after this procedure.

  A  tiny  documentation  (yamsweeper.tex)  is  provided,   but is written for
  Japanese LaTex(EUC).



3.  How to build Yamsweeper -- with loging func.

  If you want to log users who play Yamsweeper, answer "yes" to

       >Do you want to log users? [no]

  question from configure. The default location of the log file is as follows:

        /usr/local/.log/game/yams.log

  To change the location, edit Imakefile after configuration, then do xmkmf.




Appendix A  High Score

  Top-tens of each game mode (beginner,  intermidiate,  expert) are  saved  in
  high-score  file.  High  score  file  is  encrypted.  High-scoring  installs
  Yamsweeper with set-uid bit. It is recommended that you make an user such as
  "game" (!=root), and install as the user.


Appendix B  Notes for Linux users

  The randomness of this version of yamsweeper may not be enough.  If  there's
  problems regarding it, I will fix it. Please contact me.


****

Good luck and enjoy !!


                                hirofumi -- hirofumi@info.kawasaki-steel.co.jp
                                                               hirof@mix.or.jp
