
  This set of patches will allow Ularn to compile and run under Mess-Dos
using Turbo C v2.0. Installation instructions, in brief:

  1. Apply the patches.
  2. Edit ularn.lnk, and change the directory names to wherever you keep the
     Turbo C libraries.
  3. Rename 'makefile.tcc' to 'makefile'.
  4. Run make.
  5. Copy ularn.exe and the data files ufortune, uhelp, and umaps to wherever
     you want to keep them.
  6. You must have ANSI.SYS (or NANSI.SYS) installed in order to use Ularn.
  7. When running the program, you can specify your character name on the
     command line by using 'ularn character-name'. If you don't specify a
     name on the command line or in an options file, you will be asked to
     enter a name when the game starts.


  The changes that I made fall into several classes:

New features:

  1. Graphics characters. You can specify arbitrary character codes to be
used for drawing the floor and walls of the dungeon. This is done by a
line in the options file of the form 'graphics: floor-code wall-code'.
For example, I use 'graphics: 176 178'.

  2. Swapping. If memory is limited, levels that are not currently in use
will be swapped out to disk. This feature is enabled by defining the
symbol SWAPPING when compiling savelev.c.

  Warning: the savefile format has been changed. Finish any old games before
installing this version!


Modifications for MS-DOS:

  1. Location of options file. If an options file is specified on the command
line, Ularn will look for it there and abort if it isn't found. Otherwise,
Ularn will try to open the file 'ularnopt', first in the current directory,
and then in the directory in which ularn.exe is located.

  2. Location of data files. Ularn expects its data files to be in the
directory that ularn.exe is located in. This can be overridden by using
the 'larn-path:' keyword in the options file.

  3. Character name and save files. The character name can be specified on
the command line ('ularn character-name') or in the options file. If it
is given by both methods, the name specified on the command line takes
precedence. If it is given by neither, you will be asked to enter a name
when the game starts. The name used for the save file will be the first
eight characters of your character's name, followed by '.sav'. This can
be overridden, however, by using the 'savefile:' keyword in the options
file.

  4. Keypad support. If you have an IBM compatible and want to use the
keypad for movement, include the 'keypad' keyword in the options file.
You can then move around using the eight directional keys (Num Lock
should be _off_). You can run in a given direction by shifting a directional
key. Ins is equivalent to 'i' and Del is equivalent to '.'.

  5. NANSI support. If you are using NANSI.SYS instead of ANSI.SYS, you
should include the 'nansi' keyword in the options file. Ularn will then
use the insert-line and delete-line control sequences. If you have an IBM
compatible, you can also set the 'rawio' option, which results in faster
output.

  6. Screen color. You can specify the foreground and background colors
of the screen by using the options 'foreground:' and 'background:', e.g.,
'foreground: magenta' or 'background: blue'. Most combinations look pretty
ghastly, though.


Bug fixes:

  Mostly int/long mismatches. I also ran across a TC code generation bug
and had to rearrange several lines to avoid it. I'm sure there are still
some left, but I've already spent too much time ... um ... _testing_ this
program... :-)

Enjoy,

Scott Snyder
ssnyder@tybalt.caltech.edu
