Home | History | Annotate | Line # | Download | only in larn
      1  1.2  cgd $NetBSD: README,v 1.2 1995/03/23 08:33:07 cgd Exp $
      2  1.2  cgd 
      3  1.1  cgd Larn is a dungeon type game program.  Larn is a adventure/action game similar
      4  1.1  cgd in concept to rogue or hack, but with a much different feel. 
      5  1.1  cgd Try it, you'll like it!
      6  1.1  cgd 
      7  1.1  cgd You will have to edit the Makefile to reflect your configuration.  Define
      8  1.1  cgd LARNHOME as the place where the larn auxiliary files will reside, and
      9  1.1  cgd BINDIR as the place where the larn executable should be placed.  Type
     10  1.1  cgd "make" to compile, or "make all" to compile and install ("make install"
     11  1.1  cgd does just the install).
     12  1.1  cgd 
     13  1.1  cgd Here's a list of what is in each of the various source files:
     14  1.1  cgd 
     15  1.1  cgd Fixed.Bugs		 this is a list of the things that were changed
     16  1.1  cgd 				since ver 11.0
     17  1.1  cgd Makefile		 makefile script to compile the program
     18  1.1  cgd Make.lint		 makefile script to run larn sources through lint
     19  1.1  cgd README			 this is what you are now reading
     20  1.1  cgd bill.c          code for the letters of praise if player wins
     21  1.1  cgd config.c        data definitions for the installation dependent data --
     22  1.1  cgd                     savefilenames, where the scorefiles are, etc.
     23  1.1  cgd create.c        code to create the dungeon and all objects
     24  1.1  cgd data.c          data definitions for the game -- no code here
     25  1.1  cgd diag.c          code to produce diagnostic data for wizards, & savegame stuff
     26  1.1  cgd display.c       code to update the display on the screen
     27  1.1  cgd fortune.c		code for the fortune cookies
     28  1.1  cgd global.c        code for globally used functions that are specific to larn
     29  1.1  cgd header.h        constant and structure definitions
     30  1.1  cgd help.c          code for the help screens in the game of larn
     31  1.1  cgd .holidays		data file which lists upcoming holidays
     32  1.1  cgd io.c    	    code to handle file and terminal i/o
     33  1.1  cgd .larn.help.uue	larn help file (UUENCODED)
     34  1.1  cgd .larnmaze		data file for pre-made mazes
     35  1.1  cgd .larnopts		a sample .larnopts option data file
     36  1.1  cgd .lfortune		data file which contains the hints
     37  1.1  cgd main.c          code for the main command control and parsing
     38  1.1  cgd monster.c       code to handle attack and defense modes with monsters
     39  1.1  cgd moreobj.c		code for the fountains, altars, thrones
     40  1.1  cgd movem.c         code to move the monsters around the dungeon
     41  1.1  cgd nap.c           code to sleep for less than a second
     42  1.1  cgd object.c        code to handle objects in the dungeon
     43  1.1  cgd regen.c			code to regenerate the player and advance game time
     44  1.1  cgd savelev.c	code to get/put a level from level storage into working
     45  1.1  cgd 		level memory
     46  1.1  cgd scores.c        code to process and manage the scoreboard
     47  1.1  cgd signal.c        code to handle UNIX signals that are trapped
     48  1.1  cgd store.c         code for the larn thrift shoppe, bank, trading post, lrs
     49  1.1  cgd tok.c           code for the input front end and options file processing
     50  1.1  cgd 
     51  1.1  cgd To find out how to play the game, run it and type in a '?' to get the help
     52  1.1  cgd screens.  By the way, the wizards password is "pvnert(x)" and to become wizard
     53  1.1  cgd type in an underscore, you are then prompted for the password.  Wizards are
     54  1.1  cgd non-scoring characters that get enlightenment, everlasting expanded 
     55  1.1  cgd awareness, and one of every object in the game.  They help the author to debug
     56  1.1  cgd the game.
     57  1.1  cgd 
     58  1.1  cgd Note regarding the wizard id:  If you are using userid's, then WIZID must be
     59  1.1  cgd set to the userid of the person who can become wizard.  If you are using
     60  1.1  cgd player id's, WIZID must be set to the playerid (edit file .playerids if needed)
     61  1.1  cgd of the player who can become wizard.
     62  1.1  cgd 
     63  1.1  cgd You may want to clear out the scoreboard.  The command "larn -c" will make a
     64  1.1  cgd new scoreboard.  It will prompt you for the wizards password.
     65  1.1  cgd 
     66  1.1  cgd BUGS & FIXES:
     67  1.1  cgd 
     68  1.1  cgd James McNamara has volunteered to maintain the latest sources, and provide
     69  1.1  cgd latest bug fixes to anyone who asks.  Both James and I will field requests for
     70  1.1  cgd sources, for those who ask.
     71  1.1  cgd 
     72  1.1  cgd 			  ___	Prince of Gems (alias Noah Morgan)
     73  1.1  cgd 			 /.  \	USENET: panda!condor!noah
     74  1.1  cgd 			 \   /	at GenRad Inc.  Bolton MA
     75  1.1  cgd 			  \ /
     76  1.1  cgd 			   v
     77  1.1  cgd 
     78  1.1  cgd Below is some additional info about the installation of larn:
     79  1.1  cgd 
     80  1.1  cgd Install: Notes on the game LARN installation.
     81  1.1  cgd Larn is copyrighted 1986 by Noah Morgan.
     82  1.1  cgd This file (below) originally by James D. McNamara, last update 7/27/86 by nm
     83  1.1  cgd 
     84  1.1  cgd THIS DISTRIBUTION:
     85  1.1  cgd 
     86  1.1  cgd 	You should receive six (6) shar files, which are:
     87  1.1  cgd 
     88  1.1  cgd 	larn.part-1
     89  1.1  cgd 	larn.part-2
     90  1.1  cgd 	larn.part-3
     91  1.1  cgd 	larn.part-4
     92  1.1  cgd 	larn.part-5
     93  1.1  cgd 	larn.part-6
     94  1.1  cgd 
     95  1.1  cgd I.	Use /bin/sh (or your system equivalent) to "unravel" shar files
     96  1.1  cgd 	larn.part-1, ..., larn.part-6.  I suggest you do this directly
     97  1.1  cgd 	into $LARNHOME (See Section III.).  Notable files:
     98  1.1  cgd 
     99  1.1  cgd 	README	-	The author's how-to.
    100  1.1  cgd 	MANIFEST -	Files you should have.
    101  1.1  cgd 
    102  1.1  cgd III.	Edit a copy of "Makefile" and leave the edited version in $LARNHOME.
    103  1.1  cgd 
    104  1.1  cgd All the "configuration" options are tidily near the top of the "Makefile."
    105  1.1  cgd Here are the ones you probably will want to edit:
    106  1.1  cgd 
    107  1.1  cgd LARNHOME	I specified (literally) the directory, with path from root,
    108  1.1  cgd 	where "larn" will reside.  This included where I put the *.c files,
    109  1.1  cgd 	it is where the *.o files ended up, as well as all data and *.h files.
    110  1.1  cgd 	i suspect the *.c and intallation-documentation files can be moved off,
    111  1.1  cgd 	but the data and bits must all remain here for execution.
    112  1.1  cgd 
    113  1.1  cgd BINDIR		I specified (literally) the directory, with path from root,
    114  1.1  cgd 	where the executable "larn" will reside.  The "Makefile" will dump
    115  1.1  cgd 	the "a.out", named "larn", in this directory.  My BINDIR was not
    116  1.1  cgd 	my LARNHOME, so $BINDIR/larn was the ONLY file dumed here.  You'll
    117  1.1  cgd 	probably have to chmod it for public execute, etc.
    118  1.1  cgd 
    119  1.1  cgd 
    120  1.1  cgd OPTIONS		This is how *I* specified them... they are documented in-line:
    121  1.1  cgd 	OPTIONS = -DWIZZARD -DWIZID=157 -DEXTRA -DBSD -DSAVEINHOME
    122  1.1  cgd 
    123  1.1  cgd IV.	Compile the bugger.  Read "README" before you do.  You have a couple
    124  1.1  cgd 	of options here:
    125  1.1  cgd 
    126  1.1  cgd 	make			- will not install, suspect good for updates.
    127  1.1  cgd 	make all		- compile (and) intall
    128  1.1  cgd 	make install		- just install
    129  1.1  cgd 
    130  1.1  cgd 	I did "make" and then "make install" -- seems to work "ok", but
    131  1.1  cgd 	"make all" probably safer, if I had known.  Note that "Makefile"
    132  1.1  cgd 	is the default file for "make."
    133  1.1  cgd 
    134  1.1  cgd V.	Execute and have fun.  If wizard code "ok", larn -c will refresh the
    135  1.1  cgd 	scoreboard.  Play and win (or get killed) to put somebody on the
    136  1.1  cgd 	scoreboard.
    137  1.1  cgd 
    138  1.1  cgd VI.	BUGS and FIXES.
    139  1.1  cgd 
    140  1.1  cgd 	Please forward any bug-fixes in these regards to me (or Noah), so I may
    141  1.1  cgd 	compile a fix-list for other installers.  Thanks.
    142  1.1  cgd 
    143  1.1  cgd Regards,
    144  1.1  cgd ===============================================================================
    145  1.1  cgd James D. McNamara                    CSNET:   jim@bu-cs
    146  1.1  cgd                                      ARPANET: jim%bu-cs@csnet-relay
    147  1.1  cgd                                      UUCP:    ...harvard!bu-cs!jim
    148  1.1  cgd                                      BITNET:  jim%bu-cs%csnet-relay.arpa@wiscvm
    149  1.1  cgd ===============================================================================
    150  1.1  cgd 
    151