/
LPMUD/
LPMUD/DOC/
     -=[ Building Amylaar3.2@304 for MS-DOS ]=-

This document is based on John Olson's building doc.  

BUILDING of LPmud for MS-DOS           4-NOV-1991, 20-July-1994
============================


This file contains a step by step description of how to compile
Amylaar3.2@xxx LPmud on MS-DOS on 80386/80486-based systems.


BEFORE YOU START
================

Make sure you have enough free disk space. 10 MB should be enough
in most cases. You probably won't need all the space but it is
always better to be able to keep some of the .ZIP and .TAR files
on-line rather than having to copy them to floppies in order to
free some disk space.

READ THIS FILE TO THE END before doing anything. You should also
read the file README. It could be useful to verify your system's
and its setup's compatibility by installing and test running the
binary distribution first. 

There are several support files you need to build LPmud. These
are the dependencies:

  Target    File(s)                     Required parts(s)
  --------  ------------------------   ---------------------- 
  ZIP       pkz204g.exe                 PKUNZIP.EXE
  GCC       \DJGPP                      Directory
  MAKE      NDMAKE45.ZIP                MAKE45L.EXE
  YACC      BYACC19.ZIP                 BYACC.EXE
  COMPRESS  GZIP124.ZIP                 GUNZIP.EXE
  TAR       DJTARX.EXE or TAR315us.zip  DJTARX.EXE or TAR>EXE
  MUDLIB    heaven7_2@xx.tgz            Directory


FTP SITES
=========

All of the above files are available on simtel-20,

          Address           Locale      Directory, ./

 OAK    oak.oakland.edu    USA           SimTel/msdos
 OZ     archie.oz.au       Australia     micros/pc/simtel-20

There are many other simtel mirror sites.  Use the closest site.


ZIP
===

This is a zip archiver.  This package is found at simtel-20 in
the directory ./zip/pkz204g.exe.  It is needed to unarchive the
other packages.


GCC
===

DJ Delories has ported GCC 2.6.0 to MS-DOS.  This package is a
32-bit C compiler. This is available at simtel-20 in the
directory ./djgpp.  Only the basic packages which are described
in the faq are needed.

Note: This package definitely needs maintenance release 1 to work
satisfactorily.  It can be found at
omnigate.clarkson.edu:pub/msdos/djgpp/dj112m1.zip


NDMAKE
======

Make is a package that is able to maintain, and direct compiling.
Although there is a make package in ./djgpp I cannot get it to
work.  So I used ndmake instead. ndmake45.zip at simtel-20 in the
directory .\c.

Installing NDMAKE
     pkunzip -d ndmake 
     copy make45l.exe \djgpp\bin\make.exe


BYACC
=====

BYACC is a parser generator for C.  byacc19.zip is available at
simtel-20 in the directory .\txtutl 

Installing BYACC
     pkunzip -d byacc19
     copy byacc.exe \djgpp\bin\yacc.exe


COMPRESS
========

GZIP is now the standard GNU compressor.  It can uncompress
archives with the extension .gz, .z, .Z.

Installing GZIP
     pkunzip -d gzip124
     copy gzip386.exe \djgpp\bin\gunzip.exe
     copy gzip386.exe \djgpp\bin\gzip.exe


TAR
===

DJTARX is tar extract package that comes with djgpp.

djtarx <file>

If you use another tar package try,

tar -xvf <file>


MUDLIB
======

The heaven7 mudlib is available at
     ftp.ccs.neu.edu:pub/mud/mudlibs/heaven7/heaven7_2vxx.tgz


LPMUD
=====

Getting Source
--------------

Ftp to ftp.tu-bs.de.
     cd pub/games/lpmud
     binary
     get amylaar3.2@xxx.tar.gz amylaar.tgz
     quit



Installing
----------

Make home directory -
     mkdir \lpmud

Move source archive to home directory -
     copy amylaar.tgz \lpmud

Change to home directory -
     cd \lpmud

Make bin directory -
     mkdir bin

Make src directory -
     mkdir src

Make mudlib directory -
     mkdir mudlib

Uncompress source archive -
     gunzip amylaar.tgz

Extract source from tar archive -
     djtarx amylaar.tar

Rename source directory to src -
     move driver3.2@x src
or   xcopy driver3.2@x src /s/e  (for pre dos6)

Unzip amyl_dos.zip into hosts directory-
     pkunzip -d 32@xxx_s.zip \lpmud\src

Overwrite source with msdos patches-
     copy \lpmud\src\hosts\msdos\fixes\*.* \lpmud\src


READ INSTALL
Edit config.h if you want to compile driver in NATIVE_MODE, 
OLD_EXPLODE_BEHAVIOUR, no INITIALIZATION_BY___INIT, or change the 
MUD_LIB, BINDIR directories.

Edit makefile if you have a dos version older then dos6.xx

change directory to \lpmud\src
	cd \lpmud\src

Make Driver with -
	MAKE

If all goes well the driver will start to compile.  On my 386sx,
it is slow and takes a few hours.

          Zilanthius
          Ray Gilbert
          Email: c8435802@wombat.newcastle.edu.au