Added instructions on building Frotz for DOS.

diff --git a/DOSBUILD.txt b/DOSBUILD.txt
new file mode 100644 (file)
index 0000000..b7332d8
--- /dev/null
+++ b/DOSBUILD.txt
@@ -0,0 +1,50 @@
+===========================================================================
+---------------------------------------------------------------------------
+|  READ THIS FILE ALL THE WAY THROUGH BEFORE ATTEMPTING TO INSTALL FROTZ  |
+---------------------------------------------------------------------------
+===========================================================================
+
+Frotz was originally written specifically for MS/PC DOS.  When it began 
+to be ported to other machines and operating systems, the DOS port 
+lagged behind.  This has been fixed to the extent that DOS is capable of 
+the new enhancements.  For instance, DOS Frotz is now capable of using 
+Blorb files to get audio and graphical data.  The old Infocom-style 
+mechanism of doing this has been removed.  Sound is supported through 
+Soundblaster compatible sound cards.  Graphic levels from Hercules to 
+MCGA are supported.
+
+To compile DOS Frotz, you need the following:
+       * Borland Turbo C++ 3.00.  This is the latest version I'm aware 
+         of capable of building 16-bit DOS applications.
+       * PC-DOS, MS-DOS, or DR-DOS version 5.0 or higher.
+         FreeDOS works well too.
+
+==============
+Compilation ||
+==============
+
+Turbo C++ is typically installed to C:\tc.  Make sure your path contains 
+C:\tc\bin.  When this is done, type "make".  Did Borland's make program 
+run?  Now type "tcc".  If those two commands work, then you should be 
+ready to compile.
+
+Somehow get the source tree onto your DOS machine or into a DOS 
+emulation environment.  If you're using emulation, this should be as 
+simple as copying the tree you're in now into the proper directory.  For 
+real hardware, a floppy disk will do.
+
+To compile, go into the Frotz directory and type "build".  That will 
+invoke "build.bat", a batch file that simply executes "make -f 
+makefile.tc".  The reason for this is a bit of syntactic sugar to deal 
+with the fact that it is impractical to have one Makefile build both 
+Unix and DOS versions.  After about a minute, you should have FROTZ.EXE.  
+This file is all you need to run Frotz.  Put it somewhere in your path 
+and go to wherever you keep your Infocom games.  Type "frotz zork1.dat" 
+or whatever and there you go.
+
+========================
+Hardware Requirements ||
+========================
+
+The exact hardware requirements of DOS Frotz are yet to be determined.  
+Please send me reports of what Zcode works and what doesn't.

diff --git a/README.1st b/README.1st
index 258994063c5fd0b8e1ac02ebdc8d8dc38361af51..cce6f164fcb4925296b9547fd3151a02883e2eab 100644 (file)
--- a/README.1st
+++ b/README.1st
@@ -2,12 +2,15 @@ What are all these files for?
 
 AUTHORS                People who've had a hand in making Frotz what it is.
 BUGS           A list of known bugs and workarounds (if known).
+build.bat      A batch file for building Frotz for PC/MS DOS.
 COPYING                Full text of the GNU General Public License.
 ChangeLog      Summary of changes from one version to another.
+DOSBUILD.txt   How to build and install Frotz for PC/MS DOS.
 DUMB           Description of the dumb-interface version of Frotz.
 HOW_TO_PLAY    How to play Interactive Fiction.
-INSTALL                How to install Frotz.
+INSTALL                How to build and install Frotz.
 Makefile       The Makefile (the INSTALL file tells you about this).
+Makefile.tc    Makefile for building Frotz for DOS.
 PACKAGING      Putting Frotz into a binary package or port tree.
 PORTING                Notes about porting Frotz to new machines and operating systems.
 README         An overview of Frotz.