From a08bc67bf1b466e7cdb1d6b861ef821b892cf40d Mon Sep 17 00:00:00 2001 From: David Griffith Date: Fri, 25 Oct 2013 12:25:06 -0700 Subject: [PATCH] Added instructions on building Frotz for DOS. --- DOSBUILD.txt | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ README.1st | 5 ++++- 2 files changed, 54 insertions(+), 1 deletion(-) create mode 100644 DOSBUILD.txt diff --git a/DOSBUILD.txt b/DOSBUILD.txt new file mode 100644 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 2589940..cce6f16 100644 --- 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. -- 2.34.1