Return to README CVS log

Up to [CSRG BSD Unix] / 43BSDReno / games / larn

Annotation of 43BSDReno/games/larn/README, revision 1.1

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

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.