home *** CD-ROM | disk | FTP | other *** search
/ vsiftp.vmssoftware.com / VSIPUBLIC@vsiftp.vmssoftware.com.tar / FREEWARE / FREEWARE40.ZIP / xblockbuster103 / xblockbuster_readme.txt < prev    next >
Text File  |  1995-10-18  |  4KB  |  136 lines
  1. DESCRIPTION:
  2.  
  3. XBlockbuster is a variation of the break-out type games, only a bit more
  4. complex in the type of bricks it has and effects the bricks have.  It should
  5. run on any X11 system (color or black and white).
  6.  
  7. RESTRICTIONS:
  8.     This game may be freely copied or distributed as long as no fee
  9. is required.  Since the code is a mixture of both the original and my
  10. own, I make no claims on it.  However, if you do use it for something
  11. else, credit would by nice.
  12.  
  13. TO BUILD:
  14.  
  15.     If you are on a System V machine, -DSYSV will need to be added to the
  16.     DEFINES variable.
  17.  
  18.     If XBlockBuster is seems slow, or is using a lot of network bandwidth,
  19.     try defining (uncommenting) the MOTION_HINTS line near the top
  20.     of xblockbuster.h. (see CHANGES file for more information.)
  21.  
  22.     XBlockbuster can use the same playground that Blockbuster (the sunview
  23.     version) does.  If you want to use the same playground, set 
  24.     StageDir (Imakefile) or LIBDIR (Makefile.noIm) appropriately.
  25.  
  26.   IMAKEFILE directions:
  27.  
  28.     If you have already installed the stages file for xblockbuster, and
  29.     don't want to copy over them, change InstallLib in Imakefile to No.
  30.  
  31.     The Imakefile, as distributed, should work fine (unless on System V, 
  32.     see above).  You may still want to edit the Imakefile to change where the
  33.     files will be installed.  Once you have edited the Imakefile to your
  34.     satisfaction, all that is needed is:
  35.  
  36.     1) xmkmf
  37.     2) make
  38.     3) make install
  39.  
  40.   MAKEFILE directions:
  41.  
  42.     If you don't want to use the Imakefile, do the following:
  43.     1) cp Makefile.noIm Makefile
  44.     2) Edit the Makefile.  Everything should be fairly well documented.
  45.     3) make
  46.  
  47.     If you have already installed the XBlockBuster stages, and don't
  48.     want to copy over them, do:
  49.  
  50.     4) make install.bin
  51.  
  52.     If this is your first installation, or you want to copy over the
  53.     score files, do:
  54.  
  55.     4) make install
  56.  
  57.     I have successfully compiled the source with both cc and gcc on
  58.     a sun 3/sunos 4.1.1.
  59.  
  60. IF YOU HAVE PROBLEMS:
  61.  
  62.     If it can't find the font, change FONT in xblockbuster.h
  63.  
  64.     If your on system V/Ultrix machine, did you add -DSYSV to to
  65.     defines?
  66.  
  67.     If you get link errors of random or srandom not found, change RAND
  68.     and SRAND in xblockbuster.h to comparable functions for your
  69.     machine (and please send me mail, so I can make this more automatic
  70.     in the future.)  Note that RAND and SRAND are only used for
  71.     determining what the order of the stages are, so they need not
  72.     be especially good.
  73.  
  74.     Check the BUGS/TODO section to see if it is a problem I
  75.     already know about.  If it is, still send me mail, but maybe
  76.     by it being a known problem, you won't feel quite so bad.
  77.  
  78.     Other problems?  Send me mail. (see below)
  79.  
  80. FILES (of interest):
  81.  
  82. CHANGES: changes made from blockbuster to xblockbuster.
  83.  
  84. RATIONAL.SV, README.SV: Files from the original SunView version that may be
  85.     of interest to people.
  86.  
  87. XBlockbuster.ad: X Defaults I use for coloring the bricks.
  88.     NOTE: xblockbuster will not use these values if they are installed
  89.     in the standard app-defaults directory.  They MUST be read in
  90.     by xrdb, either by being in the user .Xdefaults file or by
  91.     perform xrdb on XBlockbuster.ad file itself.
  92.  
  93. icons (directory):  Contains the brick images, as well as a few other.  Brick
  94.     images with _alt in the name are the alternate images used for color.
  95.     (See the manual page for more information on coloring the bricks and
  96.     alternate bricks.)
  97.  
  98. BUGS/TODO:
  99.  
  100.  A nice opening screen, showing the bricks (with proper coloring, if 
  101. applicable), along with descriptions of what each brick does.
  102.  
  103.  Fix some of the remaining bugs (most are quite minor, or happen very
  104. infrequently)
  105.  
  106.  Use a setuid mechanism so that the save directory and score files don't
  107. need to be publicly writable.
  108.  
  109.  Make it so the xblockbuster will read in the XBlockbuster.ad file if
  110. it is stored in the standard place.
  111.  
  112.  Fix the BUGS as listed in the man page.
  113.  
  114. NOTES:
  115.     I have personally verified it works on the following:
  116.  
  117.     sun 3/60, sunos 4.1.1 (both color and black & white)
  118.  
  119.     I have gotten reports it works on the following:
  120.  
  121.     SGI with IRIS 4.0.x
  122.  
  123.  
  124.     I will maintain it and release patches as required. 
  125.  
  126.     If you send me mail, please include a valid mail address as
  127. part of your signature.  I have gotten at least a few letters where
  128. the mail address in the header was incorrect.  Also, please be
  129. sure to state the version you are using (this should appear
  130. in both the window header, and the file patchlevel.h)
  131.  
  132. Mark Wedel
  133. master@cats.ucsc.edu
  134. March 17, 1993
  135.  
  136.