home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d8xx / d822 / nethack.lha / NetHack / NH31PL0-2.lha / ReadMe < prev    next >
Text File  |  1993-02-05  |  9KB  |  211 lines
  1.  
  2.         Using and Installing Amiga NetHack 3.1
  3.       (or Everything You Never Wanted to Know Before NetHacking)
  4.  
  5.          Last Revision: 28 January 1993 for NetHack 3.1
  6.  
  7.  
  8. I. Introduction
  9.  
  10. I.A. Overview
  11.     Welcome to Amiga NetHack!  If this is your first visit to our fair
  12.     city, you are in for an amazing and dangerous journey; if you have
  13.     visited us before, beware! the city has changed in many strange and
  14.     subtle ways; it has also grown quite a bit.  This missive brings to
  15.     light those mundane tasks which must be dealt with before beginning
  16.     your journey; for those of you who are faced with the task of
  17.     installing the pre-fabricated version of our town, section III
  18.     (Installing Amiga NetHack 3.1) will guide you through the task at
  19.     hand.  If you are ready to visit, the local visitors guide is in
  20.     section II (Using Amiga NetHack 3.1); please also see the general
  21.     guide packaged separately (the file GuideBook).
  22.  
  23.     To all our visitors, a hearty Welcome! - and please be careful.
  24.  
  25.     [Those responsible for the previous paragraphs have been sacked.  The
  26.     documentation has been completed at great expense in a more traditional
  27.     style. -- The Management]
  28.  
  29. I.B. Getting Help
  30.     If you have questions about strategy, weapons, or monsters, the best
  31.     place to go for help is the Usenet newsgroup rec.games.hack.  If you
  32.     have problems with installation or think you have found a bug in
  33.     the game, please report it by electronic mail to the development
  34.     group at nethack-bugs@linc.cis.upenn.edu, where it will be routed
  35.     to the appropriate person.  Include your configuration, the version of
  36.     NetHack you are playing, and as much specific information as possible.
  37.     As NetHack runs on many different machines, be sure to mention that
  38.     you are playing the Amiga version.  Finally, if you are having trouble
  39.     compiling NetHack, you may use the same address, or, for compiler
  40.     specific problems, send mail to:
  41.         Greg Olson (golson@sundown.sun.com)  for Manx
  42.         Ken Lorber (keni@oasys.dt.navy.mil) for SAS/C, or
  43.         Richard Addison (addison@pollux.usc.edu) for either.
  44.     We do not currently have a contact for the DICE port.
  45.  
  46. I.C. Credits
  47.     Olaf Seibert first ported NetHack 2.3 and 3.0 to the Amiga.  Richard
  48.     Addison, Jochen Erwied, Mark Gooderum, Ken Lorber, Greg Olson, Mike
  49.     Passaretti, and Gregg Wonderly polished and extended the 3.0 and 3.1
  50.     ports.
  51.  
  52.  
  53. II. Using Amiga NetHack 3.1
  54.  
  55. II.A. Sources of Information
  56.     Where to go depends on what you want to find out.  If you want to find
  57.     out about distributing NetHack, read the license (in NetHack:license or
  58.     type ?i during the game).  For an introduction to NetHack, read the
  59.     GuideBook file.  Finally, for information during the game on all kinds
  60.     of things, type ? and select from the menu.
  61.  
  62. II.B. The Amiga NetHack WorkBench Front End
  63.     The Amiga NetHack Front End looks more or less like a WorkBench
  64.     Drawer - and acts the same way.  Games start with double clicks and
  65.     menus provide more detailed control of games and defaults.  On-line
  66.     help is available - just press the help key.
  67.  
  68.     Just as with WorkBench itself, options for games are set using the Info
  69.     menu item to modify Tooltypes.  Most common options can be set more 
  70.     easily using buttons available via Info also.
  71.  
  72.     You can adjust the following using the ToolTypes from the Info command:
  73.  
  74.     * OPTIONS=<options> - Options as available in the NetHack.cnf file.
  75.  
  76.     * HACKDIR=<directory> - Set NetHack working directory to be this
  77.       directory.
  78.  
  79.     * LEVELS=<levels> - Intermediate level saving device/directory.
  80.  
  81.     * PATH=<path> - To search for files such as rumors, help, etc.
  82.  
  83.     * CMDLINE=<args> - Arguments as passed on the CLI command line.
  84.       Note:  only the following flags are valid: n, X, D, and r.
  85.  
  86.     * SCORE <options> - Display the record of scores.  Options as
  87.       available on the CLI command line after a -s flag.
  88.  
  89.     Note that the NetHack.cnf file is read first, then the ToolTypes.  This
  90.     means that the options specified in the NetHack.cnf act as defaults
  91.     which can be overridden by an individual's personal icon's ToolTypes.
  92.     Thus the system oriented entries (HACKDIR, LEVELS, and PATH) should
  93.     generally be set only in NetHack.cnf.  NetHack.cnf should have default
  94.     values for OPTIONS, which will generally be overridden by ToolTypes
  95.     entries.
  96.  
  97.     Also, there is one additional option that may be specified in the
  98.     NetHack.cnf file or on an OPTIONS line: flush.  When enabled, flush
  99.     discards all characters in the queue except the first, which limits
  100.     typeahead accidents.  The default setting is noflush.
  101.  
  102.     Usually, most of the confusing options will be set in the NetHack.cnf
  103.     file once when the game is installed and can be ignored after that.
  104.  
  105. II.C. The Amiga NetHack CLI Front End
  106.     The CLI Front End provides the standard Unix-like command line interface
  107.     to NetHack.  Unlike the Unix front end however, the CLI front end will
  108.     ask if you want to play again before exiting.  See the ManPage file for
  109.     the standard Unix flags for NetHack.  In addition to those flags, Amiga
  110.     NetHack accepts flags -l to force non-interlaced mode and -L to force
  111.     interlaced mode.
  112.  
  113.  
  114. III. Installing Amiga NetHack 3.1
  115.  
  116. III.A. General Installation
  117.     Installation should be easy - basically it consists of putting files
  118.     where they belong and adding assigns to your startup.  If you are
  119.     installing from the official binary distribution, simply unpacking
  120.     each archive in the appropriate directory will put the files in the
  121.     places they belong (note that the archives may have been split
  122.     for distribution).  If you are installing from source, most of this
  123.     work will be done by the time the build is finished.
  124.  
  125.     IF YOU ALREADY HAVE A PREVIOUS VERSION INSTALLED YOU MUST DELETE THE
  126.     OLD SAVE AND BONES FILES - THEY WILL NOT WORK!
  127.  
  128. Will NetHack fit on your machine?
  129.     NetHack 3.1 is large.  NetHack 3.1 is very large.  You will need:
  130.     > Amiga 500, 1000, 2000, 2500, or 3000.  The A600, A1200, and A4000
  131.       should work, but have not been tested.
  132.     > WorkBench 1.3 or 2.04.  WorkBench 1.2 will NOT work; we will NOT
  133.       be fixing that.  WorkBench 2.1 and 3.0 should work but have not been
  134.       tested.
  135.     > At least 2 meg of RAM.  NetHack will NOT run in 1 meg.
  136.     > Mass storage: NetHack will run on one floppy - but it won't be nice.
  137.       Two floppies are almost enough.  A hard drive with over 3 meg of
  138.       free space is recommended.
  139.  
  140. Find space for the files
  141.     Floppy installation:
  142.     Format four disks named:
  143.         NetHack
  144.         HackExe
  145.         NHsave
  146.         NHlevels
  147.     Hard Disk installation:
  148.         cd to wherever you want to install NetHack
  149.     make the main NetHack directory:
  150.       makedir NetHack
  151.     and the subdirectories:
  152.       makedir NetHack/save
  153.       makedir NetHack/levels
  154.     In s:User-Sequence (under 2.0 or later) or s:Startup (under 1.3),
  155.     assign NetHack: to the NetHack directory you created above.
  156.     assign HackExe: to the same directory.
  157. Install the files
  158.     Unpack the archives in the directories or onto the disks (you can
  159.     tell what to unpack where by the file names) by cd'ing to HackExe:
  160.     and unpacking archive 1 and then to NetHack: and unpacking archive 2.
  161.     Use the table in the next section to see where things should end up.
  162.     Be sure that the file 8 ends up in NetHack:hack/8.
  163.  
  164. Configuration
  165.     Using your favorite text editor, edit NetHack:NetHack.cnf to match
  166.     your system.  Check HackExe:NetHack.dir and be sure that the paths
  167.     are correct (note that the first character of each line, the 'C' or
  168.     'D'is control information and not part of the path).  The HackWB
  169.     program uses several standard Amiga programs that must be installed
  170.     in their standard places: c:copy, c:rename.
  171.  
  172. III.B. File Location Table
  173.     NetHack:
  174.     A-filla.lev    A-fillb.lev    A-goal.lev    A-locate.lev
  175.     A-start.lev    air.lev        amii.hlp    asmodeus.lev
  176.     astral.lev    B-filla.lev    B-fillb.lev    B-goal.lev
  177.     B-locate.lev    B-start.lev    baalz.lev    bigroom.lev
  178.     C-filla.lev    C-fillb.lev    C-goal.lev    C-locate.lev
  179.     C-start.lev    castle.lev    cmdhelp        data
  180.     default.icon    dungeon        E-filla.lev    E-fillb.lev
  181.     E-goal.lev    E-locate.lev    E-start.lev    earth.lev
  182.     fakewiz1.lev    fakewiz2.lev    fire.lev    Guidebook
  183.     Guidebook.info    H-filla.lev    H-fillb.lev    H-goal.lev
  184.     H-locate.lev    H-start.lev    hack/8        hack.font
  185.     HackWB        HackWB.hlp    HackWB.info    HackCli
  186.     help        hh        history        juiblex.lev
  187.     K-filla.lev    K-fillb.lev    K-goal.lev    K-locate.lev
  188.     K-start.lev    knox.lev    license        logfile
  189.     ManPage        ManPage.info    medusa-1.lev    medusa-2.lev
  190.     minefill.lev    minetown.lev    mine_end.lev    NetHack.cnf
  191.     NetHack.c01    NetHack.d00    news        NewGame.info
  192.     opthelp        options        oracle.lev    oracles
  193.     orcus.lev    P-filla.lev    P-fillb.lev    P-goal.lev
  194.     P-locate.lev    P-start.lev    perm        quest.dat
  195.     R-filla.lev    R-fillb.lev    R-goal.lev    R-locate.lev
  196.     R-start.lev    ReadMe        ReadMe.info    record
  197.     recover        RecoverMan    RecoverMan.info    rumors
  198.     S-filla.lev    S-fillb.lev    S-goal.lev    S-locate.lev
  199.     S-start.lev    sanctum.lev    T-filla.lev    T-fillb.lev
  200.     T-goal.lev    T-locate.lev    T-start.lev    tower1.lev
  201.     tower2.lev    tower3.lev    V-filla.lev    V-fillb.lev
  202.     V-goal.lev    V-locate.lev    V-start.lev    valley.lev
  203.     W-filla.lev    W-fillb.lev    W-goal.lev    W-locate.lev
  204.     W-start.lev    water.lev    wizard1.lev    wizard2.lev
  205.     wizard3.lev    wizhelp
  206.  
  207.     HackExe:
  208.     NetHack.dir
  209.     NetHack.c00
  210.  
  211.