home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / dirs / nethack_460.lzh / NetHack / ReadMe < prev    next >
Text File  |  1991-02-17  |  7KB  |  165 lines
  1.  
  2.         Instructions for installing NetHack 3.0
  3.             on an AMIGA system
  4.     =====================================================
  5.             Last Revision: 4 February 1991
  6.  
  7. Legalese
  8. --------
  9.     NetHack is Copyright 1985, 1986, 1987, 1988, 1989, 1990
  10.     by Stichting Mathematisch Centrum and M. Stephenson.  For details
  11.     on what you may and may not do with NetHack, please see the file
  12.     'license' in this distribution (or type ?i during the game).
  13.  
  14. Overview
  15. --------
  16.     This file contains the procedure to follow when installing NetHack 3.0
  17.     on an Amiga computer system.  For information on NetHack options, please
  18.     see the manual page (note that it is a UNIX man page, so there are
  19.     features that do not apply to the Amiga).  For information on the fun
  20.     parts of the game, read the Guidebook.
  21.  
  22.     The C source (more than two megabytes of it!) for NetHack for the Amiga,
  23.     Macintosh, Atari ST, IBM PC, DEC VMS, and both BSD and SYSV UNIX is
  24.     archived on, and freely available from, the machine UUNET.UU.NET.
  25.  
  26. Requirements
  27. ------------
  28.     Amiga 500,1000,2000,2500  running WorkBench 1.3 and KickStart 1.2 or 1.3.
  29.     Amiga 3000 running WorkBench 1.3 or 2.0.  For the Amiga 3000 under 2.0,
  30.     be sure to follow the directions below (don't panic, the changes are
  31.     minor).
  32.     one meg of RAM and one floppy drive (painful, but functional)
  33. or    one meg of RAM and two floppy drives (much better)
  34. or    more than one meg of RAM and a hard disk with 2+ meg free (best)
  35.  
  36. Credits
  37. -------
  38.     Olaf Seibert first ported NetHack 2.3 and 3.0 to the Amiga.  Richard
  39.     Addison, Jochen Erwied, Mark Gooderum, Ken Lorber, Greg Olson, Mike
  40.     Passaretti, and Gregg Wonderly polished and extended the 3.0 port.
  41.  
  42. Installation Guide
  43. ------------------
  44.     This section assumes you have the following handy:
  45.  
  46.     * NetHack (executable code)
  47.     * Rumors file
  48.     * Oracle file
  49.     * All the various help and informational files (help, opthelp, etc)
  50.     * Special level files (castle, tower1, tower2, tower3, endgame)
  51.     * Amiga with at least 1 meg memory (may be optimistic....)
  52.  
  53.     And optionally:
  54.  
  55.     * Icons if WorkBench interface is to be used.  These files include
  56.         + NetHack.info
  57.         + NewGame.info
  58.         + NetHackScore.info
  59.         + Guidebook.info
  60.         + ManPage.info
  61.         + default.icon
  62.     * Special NetHack font (files hack.font and 8).
  63.  
  64.     Installation Steps:
  65.  
  66.     1) If you have a hard disk, create a directory named NetHack.
  67.        Assign Nethack: to be the path to this directory.  If you have a
  68.        floppy, format a disk named NetHack.  (If you have a hard disk
  69.        but only one meg of memory, you will probably not have enough
  70.        memory: you may need to run from a floppy.)
  71.  
  72.     2) If you have a hard disk, assign HackExe: to the above directory.
  73.        If you have a floppy, format an additional disk named HackExe.
  74.  
  75.     3) Copy Nethack, NetHack.info, NewGame.info, and NetHackScore.info
  76.        to HackExe.  Create an empty file called NewGame (WorkBench
  77.        refuses to Duplicate a project icon without a file attached).
  78.  
  79.     4) Copy the remainder of the files to NetHack:.  If you are using
  80.        the optional font, create a Hack subdirectory on NetHack:, and
  81.        copy "8" into it.  Be sure that Guidebook and Guidebook.info are
  82.        in the same directory, and that the Default Tool field points to
  83.        the More program (found on your AmigaDos System disk in the
  84.        Utilities directory).  Depending on where you got your copy of
  85.        NetHack, the Guidebook file may be called Guidebook.mss.
  86.  
  87.     5) Configure NetHack.cnf as per your configuration.  Remember not
  88.        to set GRAPHICS if you are not using the optional font.  If you
  89.        have only one meg of ram, do not use a ram disk.
  90.  
  91.     6) Note: the file 'logfile' keeps track of every game that is played
  92.        (like the score file, but you always get in).  From time to time
  93.        you will probably want to delete the old file - you MUST create
  94.        a new, empty logfile after deleting the old one (or you will be
  95.        complained at every time NetHack tries to write to it).
  96.  
  97.     7) AMIGA 3000 running AmigaDos 2.0 ONLY:
  98.        If you are using the optional font, you need to build a new
  99.        hack.font file:
  100.         copy NetHack:hack FONTS: all
  101.         FixFonts
  102.         copy FONTS:hack.font NetHack:
  103.         delete FONTS:hack all
  104.  
  105.     That's all there is to it!  If you are using the CLI interface, make sure
  106.     that the stack is set fairly large (at LEAST 40000 bytes).  Move to the
  107.     NetHack: directory, and type NetHack <cmd line options>.  If you're
  108.     using the WorkBench interface, click on the NetHack directory/disk.
  109.     You should see 3 icons.  Select the "NewGame" option, and "Duplicate"
  110.     from the WorkBench pull down menu.  This icon now represents your
  111.     personal profile.  You can now rename this icon, and tailor it to your
  112.     liking as described below.  If you start a game from the WorkBench
  113.     interface, saving the game will automatically tie the personal file icon
  114.     to the saved game.  So the next time you double click your icon, the game
  115.     will be restored.
  116.  
  117.     As mentioned above, the icon representing your personal profile can be
  118.     customized.  This is done via the the Info command available from
  119.     WorkBench.  You can adjust the following using the ToolTypes from the
  120.     WorkBench info command:
  121.  
  122.     * OPTIONS=<options> - Options as avaliable in the NetHack.cnf file.
  123.  
  124.     * HACKDIR=<directory> - Set NetHack working directory to be this
  125.       directory.
  126.  
  127.     * RAMDISK=<ram disk> - Set up ram disk option.
  128.  
  129.     * LEVELS=<levels> - Intermediate level saving device/directory.
  130.  
  131.     * PATH=<path> - To search for files such as rumors, help, etc.
  132.  
  133.     * CMDLINE=<args> - Arguments as passed on the CLI command line.
  134.       Note:  only the following flags are valid: n, X, D, and r.
  135.  
  136.     * SCORE <options> - Display the record of scores.  Options as
  137.       available on the CLI command line after a -s flag.
  138.  
  139.     Note that the NetHack.cnf file is read first, then the ToolTypes.  This
  140.     means that the options specified in the NetHack.cnf act as defaults
  141.     which can be overridden by an individual's personal icon's ToolTypes.
  142.     Thus the system oriented entries (HACKDIR, RAMDISK, LEVELS, and PATH)
  143.     should generally be set only in NetHack.cnf.  NetHack.cnf should have
  144.     default values for OPTIONS, which will generally be overridden by
  145.     ToolTypes entries.
  146.  
  147.     Also, there is one additional option that may be specified in the
  148.     NetHack.cnf file or on an OPTIONS line: flush.  When enabled, flush
  149.     discards all characters in the queue except the first, which limits
  150.     but does NOT completely eliminate the "accidents" which can occur if
  151.     you get ahead of the game when typing.  The default setting is noflush.
  152.  
  153.     This version of NetHack was compiled with Lattice C 5.10, and was linked
  154.     with catch.o.  This gives us one more tool to fight bugs with: when
  155.     possible, instead of just crashing, NetHack will ask if you want a
  156.     SnapShot created.  If you answer yes, a file called SnapShot.tb will be
  157.     created, which the Amiga NetHack team can use to assist in tracking bugs.
  158.     We are always looking to improve the game - if you find a bug, please
  159.     let us know!
  160.             - - - - - - - - - - - -
  161.  
  162. If you have problems or questions, please send email to:
  163.         nethack-bugs@linc.cis.upenn.edu
  164. Have fun!!
  165.