home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 175.dms / in.adf / READ.ME < prev   
Encoding:
Text File  |  1988-07-26  |  12.9 KB  |  269 lines
  1. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  2. * |_o_o|\\ Copyright (c) 1987 Edmund Burnette, The Software Distillery.     *
  3. * |. o.| ||        All Rights Reserved.                                     *
  4. * | .  | ||   Dave Baker         Edmund Burnette  Stan Chow    Jay Denebeim *
  5. * | o  | ||   Gordon Keener      John Mannering   Jack Rouse   John Toebes  *
  6. * |  . |//    Mary Ellen Toebes  Doug Walker                                *
  7. * ======           BBS:(919)-471-6436                                       *
  8. * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
  9.  
  10. ATTENTION:  AMIGA LARN is freely redistributable for non-commercial uses,
  11.             if this file accompanies it.  Please pass this file on with
  12.             any redistribution you do.  Any distribution without this file
  13.             is a COPYRIGHT VIOLATION.
  14.  
  15. Welcome to AMIGA LARN version 12.0B!
  16.  
  17. AMIGA LARN is brought to you through the efforts of The Software Distillery,
  18. a group committed to producing quality software for the Amiga at large.
  19.  
  20. Inquiries and flames should be directed via US Snail to:
  21.  
  22. Edmund B. Burnette
  23. 210 Willoughby Lane
  24. Cary, North Caroline 27511
  25.  
  26. or
  27.  
  28. John A. Toebes, VIII
  29. The Software Distillery
  30. 235 Trillingham Lane
  31. Cary, North Carolina 27511
  32.  
  33. or on USENET
  34.  
  35. ...mcnc!rti-sel!sas!burnette  (I check my mail once a year whether
  36.                                I need to or not)
  37. ...mcnc!rti-sel!sas!toebes
  38.  
  39. The latest version of Larn and our other projects are available for
  40. downloading from the Software Distillery bulletin board at (919)-471-6436.
  41. They can also be obtained from us directly at the above addresses.  Send US$6
  42. for a disk containing the latest Larn, or any of our other disks.  (Overseas
  43. include US$1 extra for postage).  Send a self-addressed, stamped envelope for
  44. a list of available disks.
  45.  
  46. Many Thanks to Shirley Galbrecht - Graphic Artist
  47.                SAS Institute Inc.
  48.                Box 8000 SAS Circle
  49.                Cary, North Carolina 27511
  50.   For her work on the graphics chacters.
  51.  
  52. ++++++++++++++++++++++++++++++++ ABOUT LARN +++++++++++++++++++++++++++++++++
  53.  
  54. This is a version of the public domain program LARN (copyright 1986 by
  55. Noah Morgan) implemented under AMIGADOS with the LATTICE C 3.10 compiler
  56. (from SAS Institute Inc.).
  57.  
  58. Larn is freely redistributable.  You may upload it to public bulletin
  59. boards, or give it to users groups, and individuals you feel would
  60. enjoy it.  Under no condition may you charge for Larn without explicit
  61. permission of the Software Distillery.
  62.  
  63. If you do enjoy the program and would like to support further
  64. development (and receive information on the latest updates) send a
  65. contribution to Edmund and his crew at the above address.  We welcome
  66. suggestions for improvements and upgrades.
  67.  
  68. +++++++++++++++++++++++++++++ INSTALLING LARN +++++++++++++++++++++++++++++++
  69.  
  70. Make a backup of this disk before doing anything.
  71.  
  72. You can use the Icon Editor 'HackIconII' to change any of the colors or
  73. characters used by the graphics version of Larn.  The characters for monsters
  74. and objects are kept in the files '.monsters' and '.objects' respectively.
  75. See the files 'HackIconII.doc', '.monsters.doc', and '.objects.doc' for more
  76. information.  HackIconII was written by Doug Walker.
  77.  
  78. There is also a configuration file '.larnopts' that you will want to edit
  79. to set your default options and player name.  See the online help in larn
  80. (the HELP key) for more information.
  81.  
  82. To install Larn on a hard disk, make a directory called DH0:LARN and copy
  83. the files from the disk into it.  Then enter the CLI command 
  84.  
  85.    assign Larn: dh0:Larn
  86.  
  87. You can then execute Larn normally.
  88.  
  89. +++++++++++++++++++++++++++++++ COMMON PROBLEMS ++++++++++++++++++++++++++++
  90.  
  91. If Larn comes up with a totally black screen that stays black, check the
  92. Workbench screen behind the Larn screen.  There may be a requester back
  93. there begging for your attention.
  94.  
  95. Larn is a memory- and stack- intensive program.  You need at least a 512K
  96. machine to run it.  If you invoke it from the CLI, YOU MUST HAVE AT LEAST
  97. 10K OF STACK.  You can ensure this with the CLI STACK command:
  98.  
  99.    stack 10000
  100.  
  101. If you invoke Larn from Workbench, you don't have to worry about the stack
  102. size since it is preset to 10000.
  103.  
  104. Besides stack space, Larn uses a lot of dynamically allocated memory.
  105. If Larn keeps crashing unexpectedly, especially near the beginning of the
  106. game, chances are you are running out of memory.  Try running it with no
  107. background tasks and as few as possible open windows.  If you execute it
  108. from Workbench, close all CLI windows before executing Larn so it can
  109. shut down the Workbench while running.  Also, Version 1.2 of the ROM Kernel
  110. seems to take more memory that Version 1.1, so try 1.1 if you are having
  111. trouble with 1.2.
  112.  
  113. You should not have to use this method, but if all else fails...
  114. If you are still running out of memory, reboot your machine and hit control-D
  115. as soon as you see the first AmigaDos window appear.  Execute the stack
  116. command above, change directories to Larn:, and resize the window to as small
  117. as possible.  Then type the Larn command:
  118.  
  119.    stack 10000
  120.    cd Larn:
  121.    Larn
  122.  
  123. If you get a requester asking for you to insert the volume 'LARN' in any
  124. drive when you go to run your copied version of Larn, then you need to rename
  125. the copied disk to LARN using either the CLI relabel command or the rename
  126. option from workbench.  A common (VERY common) mistake is to delete the
  127. 'copy of' text from in front of the name leaving the space in front of LARN
  128. (Workbench likes to put 'copy of ' in front of any disk copied).  Make sure
  129. you delete the leading space also.
  130.  
  131. +++++++++++++++++++++++++++++++ PLAYING LARN ++++++++++++++++++++++++++++++++
  132.  
  133. If you've played Larn under UN*X or some other environment, you won't have
  134. any trouble with this version.  Many of the commands are the same.  Even if
  135. you haven't, however, you can use the menus in AMIGA LARN.  Just hold down
  136. the right menu button and select the command.  After you get to know the
  137. commands, you will be able to use the keyboard commands.  The keyboard
  138. command equivalent for each menu selection is listed next to the selection.
  139.  
  140. Three commands you will want to know are HELP, '/', and ALT-click.  Pressing
  141. the HELP or '?' key gets you into the online help system.  The '/' command
  142. displays all graphics characters used in the game.  Finally, to identify a
  143. particular graphics character on the screen, point the mouse at a character,
  144. hold the ALT key, and click on the monster or object you want identified.
  145.  
  146. Before you play, you might want to print out the file '.larn.help'. This is
  147. the file displayed with the HELP key.
  148.  
  149. You can use all the standard 'vi' style keys to move your player character
  150. around in Larn.  This is the way I prefer to play the game because it keeps
  151. my fingers in the same place I need them for entering commands and answering
  152. prompts.
  153.  
  154. For your convenience, however, you can also use the arrow and keypad keys.
  155. In addition, you can control your character three ways with the mouse.
  156. First, if you just click the mouse anywhere in the playing area, the
  157. character will try to move in that direction.  Second, you can click on your
  158. character and drag it wherever you want.  This is called 'mouse tracking'.
  159. Third, to make your character stay where it he is, just click on the
  160. character and release.  This is equivilent to the '.' command.  All this
  161. is explained in the online help.
  162.  
  163. NOTE:  For your safety, Larn will not allow you to move over known traps
  164. and pits with the mouse.  Also, if a monster takes a swipe at you while
  165. you are under mouse tracking, the tracking will be dropped.
  166.  
  167. In case you're interested, when you are moving the player character with the
  168. mouse, Larn tries to move into one of the three cells next to the current
  169. player position that are closest to the mouse.  It tries them in order of
  170. increasing distance.  If all three are blocked, it gives up and does not
  171. move the player (a cell is considered blocked if there is a wall or a
  172. visible trap there).  There is a special case if the player is right next
  173. to the mouse position but for some reason it can't move to that spot (for
  174. example, if the mouse was over a wall or pit).  If that happens, Larn gives
  175. up immediately.  Otherwise, it would probably thrash back and forth between
  176. adjacent squares and waste lots of time.  This is because when mouse tracking
  177. is on, Larn tries constantly to keep the player directly under the mouse.
  178. If the mouse for some reason gets ahead of the player, Larn will move the
  179. player multiple times to let him catch up.
  180.  
  181. +++++++++++++++++++++++++++++ 12.0B Changes +++++++++++++++++++++++++++++++++
  182.  
  183. Bug Fixes
  184.    Bugs?  What bugs?
  185. Additional Features
  186.    A clikable READ.ME file (this here document).
  187. Amiga Features
  188.    Nicer icons for starting the game from the Workbench (peel-away style
  189.    created using ZapIcon and SetAlternate).
  190.    Larn now closes the Workbench to free up extra memory. Close all
  191.    non-Workbench windows (like your CLI) to get the full effect.
  192.  
  193. +++++++++++++++++++++++++++++ WIZARD Mode ! ++++++++++++++++++++++++++++++++
  194.  
  195. Wizard mode under Larn allows you to play with almost complete
  196. invulnerability.  It is there to allow you to learn some of the finer points
  197. of Larn (and to help the me debug the program!).  To get into wizard mode,
  198. you must first make sure you are using the player name of "Wizard" in your
  199. .larnopts file:
  200.  
  201.    name: "Wizard"
  202.  
  203. This is not enough since you can play a perfectly normal game using this
  204. player name.  You must get into Larn and type the '_' command.  Larn will
  205. prompt for a password which happens to be 'amiga' (no quotes or carriage
  206. return). This mode gives you a +25 lance of death, a +50 ring of protection,
  207. 25 levels of experience, and one of everthing in the game.  It is useful for
  208. learning the game or for working off frustration (much better than kicking
  209. the stairs).  Once you are in, there is no way out of wizard mode!
  210.  
  211. One caveat: wizard mode will not allow you to save high scores (that would
  212. be cheating, wouldn't it?)
  213.  
  214. +++++++++++++++++++++ Help for the Beginning Programmer ++++++++++++++++++++
  215. If you are struggling with the Amiga and with learning how to program or 
  216. simply use your Amiga, there are two excellent sources of information:
  217.    Amazing Computing - generally available from your local Amiga dealer.
  218.      It is a 'slick' cover magazine with advertising and fairly high level
  219.      coverage of basic Amiga operations.  It has been extremely informative
  220.      and covers may advanced programming topics with farily indepth articles.
  221.         Available from your local dealer
  222.    The Amigan - PO Box 411, Hatteras NC 27511 - $24 for 6 issues/year
  223.      subtitled 'Apprentice and Journeyman', the Amigan is aimed at both the
  224.      beginning programmer and advanced hacker.  The editor, Dick Barnes has
  225.      a very readable style, making for easy and informative reading.  The
  226.      journal comes on 3 hole punched paper ready for building an ongoing
  227.      reference manual for the Amiga.  The articles tend to focus on solutions
  228.      to problems and approaches to take.  No advertising is taken so all
  229.      reviews are fair and hard-hitting.  Unlike other 'help' newsletters that
  230.      tend to be fly-by-night, the Amigan is informative and committed to
  231.      providing useful tips to make your life easier and more productive. A
  232.      must for the serious Amiga Programmer.
  233.  
  234. +++++++++++++++++++++ Other Public Domain Software ++++++++++++++++++++++++
  235.  
  236. Fred Fish
  237.  345 Scottsdale Rd
  238.  Pleasant Hill, CA 94523
  239.  
  240. Offers (now 50) disks of PD software for $6 each.  These are well organized
  241. and a MUST for any user group.
  242.  
  243.  
  244. ++++++++++++++++++++++ From the Software Distillery +++++++++++++++++++++++
  245. Other programs from the Software Distillery may be obtaining by calling our
  246. Bulletin board.  Many of these programs were used in the development of
  247. Larn.  At present we offer the following:
  248.  * C-Kermit (by Jack Rouse) - A telecommunications program that implements
  249.    the full Kermit protocol with many features such as remote commands and
  250.    batch file transfers.
  251.  * An advanced UN*X MAKE program with default rules and macro expansions.
  252.  * POPCLI - a screen saver program and 'hot-key' extension for bringing up
  253.    a new cli at the touch of a key.
  254.  * ICONEXEC - a program for making AmigaDOS programs run from workbench 
  255.    without any changes.
  256.  * SETALTERNATE a program for setting the alternate (selected) image on an 
  257.    icon to other than inverse.
  258.  * BLINK - an Amiga Linker that is FULLY ALINK compatible and up to 4 times
  259.    faster.  It supports many advanced linking features as well as an
  260.    excellent map facility.  A must for the serious programmer.
  261.  * TSIZE - a utility to list the amount of disk space taken up by tree
  262.    structured directories on a disk.  VERY useful when trying to clean up
  263.    on a disk (What *IS* taking so much space?!), especially for hard disks.
  264.  * WBRUN - A program for running workbench programs from CLI without having
  265.    to load workbench.
  266.  * MEMWATCH - A background utility to watch for ramdom memory trashing.
  267.  * HACK, another UN*X game ported to the Amiga by John Toebes.  A classic
  268.    every Amigan should have.
  269.