home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / games / yam11 / README.TXT < prev    next >
Text File  |  1995-07-27  |  6KB  |  148 lines
  1. YAM, Version 1.10, July 27, 1995
  2. Copyright (c) 1995 Bermuda Software Publishing
  3. Written by Bruno Essmann (bessmann@iiic.ethz.ch)
  4.  
  5. New in Release 1.10
  6. ===================
  7.  
  8. There are only some minor changes, but I think it's worth releasing a new
  9. version even if the last release was only a fortnight ago.
  10.  
  11. - the most important change is the removal of recursion in the procedure
  12.   which does the field check, this drastically reduces the memory required
  13.   to run YAM (and the error "out of system memory" should not appear 
  14.   anymore unless you're really short of memory)
  15. - the size of the executable and the memory needed to run YAM has been
  16.   reduced by about 1KB by a utility called 'aka' by David Palmer (thanks)
  17.   in addition the help file is slightly smaller (about 1KB) so the total
  18.   size reduction of the files on disk is about 2KB
  19. - online help works in the dialogs "Set preferences", "Setup sounds" and
  20.   "Custom game" (the help key is captured in most cases, just press the
  21.   help key long enough and the online help will appear)
  22. - the "Set preferences" dialog has been split up into two dialogs "Set
  23.   preferences" and "Setup sounds".
  24.  
  25. Introduction
  26. ============
  27.  
  28. YAM is Yet Another Minesweeper for the Psion Series 3a. It will not run
  29. on a Series 3 but feel free to port it, the code is available separately.
  30.  
  31. There have been two reasons for me to write yet another minesweeper.
  32. Firstly I didn't like the various other minesweepers available (no offence
  33. meant to the authors of those programs, I just didn't like them) and
  34. secondly I wanted to find out if OPL is suited to write 'real' applications
  35. or if it's a mere tool to enhance the built-in calculator. The conclusion
  36. is that I don't like OPL as an programming language. Of course it's better
  37. than nothing, but it lacks all the enhancements of modern programming
  38. languages like Modula-2 or Oberon-2. Fortunately there exist preprocessors
  39. ('s3atrans' for MS-DOS computers and 'opl_pp' for the Psion Series 3a) else
  40. I wouldn't have had the nerve to finish this minesweeper.
  41.  
  42. Principles of Operation
  43. =======================
  44.  
  45. YAM looks and behaves like the built-in Psion applications. Care has been
  46. taken to use the standard keyboard accelerators (if you don't like them get
  47. a copy of the source code and change them to your suits).
  48. To learn how to play (and about the object of the game if you don't know
  49. it already) press Help, all instructions are included in the online help.
  50.  
  51. Hardware Requirements
  52. =====================
  53.  
  54. 1) Psion Series 3a
  55. 2) at least 22 KB of free memory (or 16 KB without the helpfile)
  56.  
  57. Installation
  58. ============
  59.  
  60. The installation kit consists of the following files:
  61.  
  62. name         contents
  63.  
  64. README.TXT   this text
  65. INSTALL.TXT  installation script for use with MCLINK
  66. YAM.OPA      minesweeper application (required)
  67. YAM.PIC      minesweeper pictures (required)
  68. YAM.HLP      minesweeper online help (optional)
  69.  
  70. to load
  71.  
  72. 1) make shure the computer can connect to the Series 3a
  73. 2) execute MCLINK.EXE @INSTALL.TXT
  74.  
  75. remarks:
  76. 1) to copy yam to a drive other than M: edit INSTALL.TXT accordingly.
  77. 2) if you're short of free ram remove the line containing YAM.HLP from
  78.    INSTALL.TXT, the help file is not required but recommended.
  79. 3) if you are using RCom modify the INSTALL.TXT accordingly and save
  80.    it as INSTALL.BAT or execute the commands manually.
  81.  
  82. to install
  83.  
  84. 1) move to the desired location on the system screen
  85. 2) press Psion-I and enter YAM.OPA in the installation dialogue
  86.  
  87. Files and Folders
  88. =================
  89.  
  90. For YAM to function properly the files have to be stored at the following
  91. locations:
  92.  
  93. name         location
  94.  
  95. YAM.OPA      wherever you want, default is \APP\ (on any drive)
  96. YAM.PIC      \APP\YAM\ (on any drive)
  97. YAM.HLP      \APP\YAM\ (on any drive)
  98. YAM.INI      M:\APP\YAM\ (will be created automagically, see below)
  99.  
  100. When YAM is started the first time it will create a file called YAM.INI
  101. which holds the configuration data. Since this file will be modified
  102. whenever you change the settings or if a new highscore is achieved this
  103. file will be stored on the internal drive in the folder \APP\YAM\. If
  104. you deinstall YAM don't forget to delete this file as well.
  105.  
  106. Contact Address
  107. ===============
  108.  
  109. YAM, Yet Another Minesweeper
  110. Bermuda Software Publishing
  111. Attn Bruno Essmann
  112. Duebendorfstrasse 184/02
  113. CH-8051 Zuerich
  114.  
  115. E-mail: bessmann@iiic.ethz.ch
  116.  
  117. Freeware
  118. ========
  119.  
  120. YAM and its source code are freeware.
  121.  
  122. I decided to release YAM as freeware because there is a nasty trend that
  123. everybody who writes even a small application thinks that he'll get money
  124. for it. The result is that there are a lot of crippleware applications.
  125. I've spent about 15 hours writing YAM and I did it because programming is
  126. one of my hobbies. I don't have spare time either, I take the time for
  127. programming since it's fun (at least sometimes) and as a basic rule I
  128. release all applications that took less than, say 100 hours to write as
  129. freeware.
  130.  
  131. Disclaimer
  132. ==========
  133.  
  134. Permission to use, copy, modify or distribute this software and its
  135. documentation for any purpose is hereby granted without fee, provided that
  136. the above copyright notice appear in all copies and that both that copyright
  137. notice and this permission notice appear in supporting documentation, and 
  138. that the name of Bermuda Software Publishing not be used in advertising or
  139. publicity pertaining to distribution of the software without specific,
  140. written prior permission.
  141.  
  142. Bermuda Software Publishing disclaims all warranties with regard to this
  143. software, including all implied special, indirect or consequential damages
  144. or any damages whatsoever resulting from loss of use, data or profits,
  145. whether in an action of contract, negligence or other tortious action,
  146. arising out of or in connection with the use or performance of this software.
  147.  
  148.