Merge pull request #585 from kiwisincebirth/map/infocom1

Added Infocom Disk Image

Doc/ChangeLog.txt

@@ -15,6 +15,7 @@ Version 3.6
 - WBW: Support ROM-based font storage
 - MAP: New Slice Inventory Rom App "S" display bootable slices, during boot
 - MAP: Device Inventory moved from HBIOS to Rom App, saving >1k space in HBIOS
+- MAP: Added disk image for all Infocom text adventure Games
 
 Version 3.5.1
 -------------

ReadMe.md

@@ -7,7 +7,7 @@
 **RomWBW Introduction** \
 Version 3.6 \
 Wayne Warthen  ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \
-29 Jun 2025
+06 Jul 2025
 
 # Overview
 
@@ -307,8 +307,10 @@ let me know if I missed you!
   - significant content in the Disk Catalog and User Guide
   - creation of the Introduction and Hardware documents
   - Z3PLUS operating system disk image
+  - Infocom text adventure game disk image
   - COPYSL, and SLABEL utilities
   - Display of bootable slices via “S” command during startup
+  - Optimisations of HBIOS and CBIOS to reduce overall code size
   - a feature for RomWBW configuration by NVRAM
   - the /B bulk mode of disk assignment to the ASSIGN utility
 

ReadMe.txt

@@ -1,14 +1,14 @@
 RomWBW Introduction
 Wayne Warthen (wwarthen@gmail.com)
-29 Jun 2025
+06 Jul 2025
 
 
 
 
 
 
-OVERVIEW
 
+Overview
 
 RomWBW software provides a complete, commercial quality implementation
 of CP/M (and work-alike) operating systems and applications for modern
@@ -17,19 +17,16 @@ Z80/180/280 retro-computing hardware systems.
 A wide variety of platforms are supported including those produced by
 these developer communities:
 
-- RetroBrew Computers (https://www.retrobrewcomputers.org)
-- RC2014 (https://rc2014.co.uk),
-  RC2014-Z80 (https://groups.google.com/g/rc2014-z80)
-- Retro Computing (https://groups.google.com/g/retro-comp)
-- Small Computer Central (https://smallcomputercentral.com/)
+-   RetroBrew Computers (https://www.retrobrewcomputers.org)
+-   RC2014 (https://rc2014.co.uk),
+    RC2014-Z80 (https://groups.google.com/g/rc2014-z80)
+-   Retro Computing (https://groups.google.com/g/retro-comp)
+-   Small Computer Central (https://smallcomputercentral.com/)
 
 A complete list of the currently supported platforms is found in RomWBW
 Hardware .
 
-
-
-DESCRIPTION
-
+Description
 
 Primary Features
 
@@ -41,16 +38,16 @@ Card) and move it between systems transparently.
 
 Supported hardware features of RomWBW include:
 
-- Z80 Family CPUs including Z80, Z180, and Z280
-- Banked memory services for several banking designs
-- Disk drivers for RAM, ROM, Floppy, IDE ATA/ATAPI, CF, SD, USB, Zip,
-  Iomega
-- Serial drivers including UART (16550-like), ASCI, ACIA, SIO
-- Video drivers including TMS9918, SY6545, MOS8563, HD6445, Xosera
-- Keyboard (PS/2) drivers via VT8242 or PPI interfaces
-- Real time clock drivers including DS1302, BQ4845
-- Support for CP/NET networking using Wiznet, MT011 or Serial
-- Built-in VT-100 terminal emulation support
+-   Z80 Family CPUs including Z80, Z180, and Z280
+-   Banked memory services for several banking designs
+-   Disk drivers for RAM, ROM, Floppy, IDE ATA/ATAPI, CF, SD, USB, Zip,
+    Iomega
+-   Serial drivers including UART (16550-like), ASCI, ACIA, SIO
+-   Video drivers including TMS9918, SY6545, MOS8563, HD6445, Xosera
+-   Keyboard (PS/2) drivers via VT8242 or PPI interfaces
+-   Real time clock drivers including DS1302, BQ4845
+-   Support for CP/NET networking using Wiznet, MT011 or Serial
+-   Built-in VT-100 terminal emulation support
 
 A dynamic disk drive letter assignment mechanism allows mapping
 operating system drive letters to any available disk media.
@@ -61,7 +58,6 @@ any drive letter. This overcomes the inherent size limitations in legacy
 OSes and allows up to 2GB of addressable storage on a single device,
 with up to 128MB accessible at any one time.
 
-
 Included Software
 
 Multiple disk images are provided in the distribution. Most disk images
@@ -73,29 +69,28 @@ changing media.
 
 Some of the included software:
 
-- Operating Systems (CP/M 2.2, ZSDOS, NZ-COM, CP/M 3, ZPM3, Z3PLUS, QPM
-  )
-- Support for other operating systems, p-System, FreeRTOS, and FUZIX.
-- Programming Tools (Z80ASM, Turbo Pascal, Forth, Cowgol)
-- C Compiler’s including Aztec-C, and HI-TECH C
-- Microsoft Basic Compiler, and Microsoft Fortran
-- Some games such as Colossal Cave, Zork, etc
-- Wordstar Word processing software
+-   Operating Systems (CP/M 2.2, ZSDOS, NZ-COM, CP/M 3, ZPM3, Z3PLUS,
+    QPM )
+-   Support for other operating systems, p-System, FreeRTOS, and FUZIX.
+-   Programming Tools (Z80ASM, Turbo Pascal, Forth, Cowgol)
+-   C Compiler’s including Aztec-C, and HI-TECH C
+-   Microsoft Basic Compiler, and Microsoft Fortran
+-   Some games such as Colossal Cave, Zork, etc
+-   Wordstar Word processing software
 
 Some of the provided software can be launched directly from the ROM
 firmware itself:
 
-- System Monitor
-- Operating Systems (CP/M 2.2, ZSDOS)
-- ROM BASIC (Nascom BASIC and Tasty BASIC)
-- ROM Forth
+-   System Monitor
+-   Operating Systems (CP/M 2.2, ZSDOS)
+-   ROM BASIC (Nascom BASIC and Tasty BASIC)
+-   ROM Forth
 
 A tool is provided that allows you to access a FAT-12/16/32 filesystem.
 The FAT filesystem may be coresident on the same disk media as RomWBW
 slices or on stand-alone media. This makes exchanging files with modern
 OSes such as Windows, MacOS, and Linux very easy.
 
-
 ROM Distribution
 
 The RomWBW Repository (https://github.com/wwarthen/RomWBW) on GitHub is
@@ -130,20 +125,20 @@ file describing the contents in detail. In summary, these directories
 are:
 
   -------------------------------------------------------------------------
-  DIRECTORY   DESCRIPTION
+  Directory   Description
   ----------- -------------------------------------------------------------
-  BINARY      The final output files of the build process are placed here.
+  Binary      The final output files of the build process are placed here.
               Most importantly, the ROM images with the file names ending
               in “.rom” and disk images ending in .img.
 
-  DOC         Contains various detailed documentation, both RomWBW
+  Doc         Contains various detailed documentation, both RomWBW
               specifically as well as the operating systems and
               applications.
 
-  SOURCE      Contains the source code files used to build the software and
+  Source      Contains the source code files used to build the software and
               ROM images.
 
-  TOOLS       Contains the programs that are used by the build process or
+  Tools       Contains the programs that are used by the build process or
               that may be useful in setting up your system.
   -------------------------------------------------------------------------
 
@@ -155,7 +150,6 @@ build custom ROM firmware under Windows are included – no need to
 install assemblers, etc. The firmware can also be built using Linux or
 MacOS after confirming a few standard tools have been installed.
 
-
 Installation & Operation
 
 In general, installation of RomWBW on your platform is very simple. You
@@ -168,30 +162,30 @@ Complete instructions for installation and operation of RomWBW are found
 in the RomWBW User Guide. It is also a good idea to review the Release
 Notes for helpful release-specific information.
 
-
 Documentation
 
 There are several documents that form the core of the RomWBW
 documentation:
 
-- RomWBW User Guide is the main user guide for RomWBW, it covers the
-  major topics of how to install, manage and use RomWBW, and includes
-  additional guidance to the use of some of the operating systems
-  supported by RomWBW
+-   RomWBW User Guide is the main user guide for RomWBW, it covers the
+    major topics of how to install, manage and use RomWBW, and includes
+    additional guidance to the use of some of the operating systems
+    supported by RomWBW
 
-- RomWBW Hardware contains a description of all the hardware platforms,
-  and devices supported by RomWBW.
+-   RomWBW Hardware contains a description of all the hardware
+    platforms, and devices supported by RomWBW.
 
-- RomWBW Applications is a reference for the ROM-hosted and OS-hosted
-  applications created or customized to enhance the operation of RomWBW.
+-   RomWBW Applications is a reference for the ROM-hosted and OS-hosted
+    applications created or customized to enhance the operation of
+    RomWBW.
 
-- RomWBW Disk Catalog is a reference for the contents of the disk images
-  provided with RomWBW, with a description of many of the files on each
-  image
+-   RomWBW Disk Catalog is a reference for the contents of the disk
+    images provided with RomWBW, with a description of many of the files
+    on each image
 
-- RomWBW System Guide discusses much of the internal design and
-  construction of RomWBW. It includes a reference for the RomWBW HBIOS
-  API functions.
+-   RomWBW System Guide discusses much of the internal design and
+    construction of RomWBW. It includes a reference for the RomWBW HBIOS
+    API functions.
 
 An online HTML version of this documentation is hosted at
 https://wwarthen.github.io/RomWBW.
@@ -205,23 +199,20 @@ in which it enhances the operation of the included applications and
 operating systems.
 
 Since RomWBW is purely a software product for many different platforms,
-the documentation does NOT cover hardware construction, configuration,
+the documentation does not cover hardware construction, configuration,
 or troubleshooting – please see your hardware provider for this
 information.
 
-
-
-SUPPORT
-
+Support
 
 Getting Assistance
 
 The best way to get assistance with RomWBW or any aspect of the
 RetroBrew Computers projects is via one of the community forums:
 
-- RetroBrew Computers Forum
-- RC2014 Google Group
-- retro-comp Google Group
+-   RetroBrew Computers Forum
+-   RC2014 Google Group
+-   retro-comp Google Group
 
 Submission of issues and bugs are welcome at the RomWBW GitHub
 Repository.
@@ -229,15 +220,11 @@ Repository.
 Also feel free to email Wayne Warthen at wwarthen@gmail.com. I am happy
 to provide support adapting RomWBW to new or modified systems
 
-
-
-CONTRIBUTIONS
-
+Contributions
 
 All source code and distributions are maintained on GitHub.
 Contributions of all kinds to RomWBW are very welcome.
 
-
 Acknowledgments
 
 I want to acknowledge that a great deal of the code and inspiration for
@@ -246,116 +233,119 @@ RetroBrew Computers Community. I sincerely appreciate all of their
 contributions. The list below is probably missing many names – please
 let me know if I missed you!
 
-- Andrew Lynch started it all when he created the N8VEM Z80 SBC which
-  became the first platform RomWBW supported. Some of his original code
-  can still be found in RomWBW.
+-   Andrew Lynch started it all when he created the N8VEM Z80 SBC which
+    became the first platform RomWBW supported. Some of his original
+    code can still be found in RomWBW.
 
-- Dan Werner wrote much of the code from which RomWBW was originally
-  derived and he has always been a great source of knowledge and advice.
+-   Dan Werner wrote much of the code from which RomWBW was originally
+    derived and he has always been a great source of knowledge and
+    advice.
 
-- Douglas Goodall contributed code, time, testing, and advice in “the
-  early days”. He created an entire suite of application programs to
-  enhance the use of RomWBW. Unfortunately, they have become unusable
-  due to internal changes within RomWBW. As of RomWBW 2.6, these
-  applications are no longer provided.
+-   Douglas Goodall contributed code, time, testing, and advice in “the
+    early days”. He created an entire suite of application programs to
+    enhance the use of RomWBW. Unfortunately, they have become unusable
+    due to internal changes within RomWBW. As of RomWBW 2.6, these
+    applications are no longer provided.
 
-- Sergey Kiselev created several hardware platforms for RomWBW including
-  the very popular Zeta.
+-   Sergey Kiselev created several hardware platforms for RomWBW
+    including the very popular Zeta.
 
-- David Giles created support for the Z180 CSIO which is now included SD
-  Card driver.
+-   David Giles created support for the Z180 CSIO which is now included
+    SD Card driver.
 
-- Phil Summers contributed the Forth and BASIC adaptations in ROM, the
-  AY-3-8910 sound driver, DMA support, and a long list of general code
-  and documentation enhancements.
+-   Phil Summers contributed the Forth and BASIC adaptations in ROM, the
+    AY-3-8910 sound driver, DMA support, and a long list of general code
+    and documentation enhancements.
 
-- Ed Brindley contributed some of the code that supports the RCBus
-  platform.
+-   Ed Brindley contributed some of the code that supports the RCBus
+    platform.
 
-- Spencer Owen created the RC2014 series of hobbyist kit computers which
-  has exponentially increased RomWBW usage. Some of his kits include
-  RomWBW.
+-   Spencer Owen created the RC2014 series of hobbyist kit computers
+    which has exponentially increased RomWBW usage. Some of his kits
+    include RomWBW.
 
-- Stephen Cousins has likewise created a series of hobbyist kit
-  computers at Small Computer Central and is distributing RomWBW with
-  many of them.
+-   Stephen Cousins has likewise created a series of hobbyist kit
+    computers at Small Computer Central and is distributing RomWBW with
+    many of them.
 
-- Alan Cox has contributed some driver code and has provided a great
-  deal of advice.
+-   Alan Cox has contributed some driver code and has provided a great
+    deal of advice.
 
-- The CP/NET client files were developed by Douglas Miller.
+-   The CP/NET client files were developed by Douglas Miller.
 
-- Phillip Stevens contributed support for FreeRTOS.
+-   Phillip Stevens contributed support for FreeRTOS.
 
-- Curt Mayer contributed the original Linux / MacOS build process.
+-   Curt Mayer contributed the original Linux / MacOS build process.
 
-- UNA BIOS and FDISK80 are the products of John Coffman.
+-   UNA BIOS and FDISK80 are the products of John Coffman.
 
-- FLASH4 is a product of Will Sowerbutts.
+-   FLASH4 is a product of Will Sowerbutts.
 
-- CLRDIR is a product of Max Scane.
+-   CLRDIR is a product of Max Scane.
 
-- Tasty Basic is a product of Dimitri Theulings.
+-   Tasty Basic is a product of Dimitri Theulings.
 
-- Dean Netherton contributed eZ80 CPU support, the sound driver
-  interface, and the SN76489 sound driver.
+-   Dean Netherton contributed eZ80 CPU support, the sound driver
+    interface, and the SN76489 sound driver.
 
-- The RomWBW Disk Catalog document was produced by Mykl Orders.
+-   The RomWBW Disk Catalog document was produced by Mykl Orders.
 
-- Rob Prouse has created many of the supplemental disk images including
-  Aztec C, HiTech C, SLR Z80ASM, Turbo Pascal, Microsoft BASIC Compiler,
-  Microsoft Fortran Compiler, and a Games compendium.
+-   Rob Prouse has created many of the supplemental disk images
+    including Aztec C, HiTech C, SLR Z80ASM, Turbo Pascal, Microsoft
+    BASIC Compiler, Microsoft Fortran Compiler, and a Games compendium.
 
-- Martin R has provided substantial help reviewing and improving the
-  User Guide and Applications documents.
+-   Martin R has provided substantial help reviewing and improving the
+    User Guide and Applications documents.
 
-- Mark Pruden has made a wide variety of contributions including:
+-   Mark Pruden has made a wide variety of contributions including:
 
-  - significant content in the Disk Catalog and User Guide
-  - creation of the Introduction and Hardware documents
-  - Z3PLUS operating system disk image
-  - COPYSL, and SLABEL utilities
-  - Display of bootable slices via “S” command during startup
-  - a feature for RomWBW configuration by NVRAM
-  - the /B bulk mode of disk assignment to the ASSIGN utility
+    -   significant content in the Disk Catalog and User Guide
+    -   creation of the Introduction and Hardware documents
+    -   Z3PLUS operating system disk image
+    -   Infocom text adventure game disk image
+    -   COPYSL, and SLABEL utilities
+    -   Display of bootable slices via “S” command during startup
+    -   Optimisations of HBIOS and CBIOS to reduce overall code size
+    -   a feature for RomWBW configuration by NVRAM
+    -   the /B bulk mode of disk assignment to the ASSIGN utility
 
-- Jacques Pelletier has contributed the DS1501 RTC driver code.
+-   Jacques Pelletier has contributed the DS1501 RTC driver code.
 
-- Jose Collado has contributed enhancements to the TMS driver including
-  compatibility with standard TMS register configuration.
+-   Jose Collado has contributed enhancements to the TMS driver
+    including compatibility with standard TMS register configuration.
 
-- Kevin Boone has contributed a generic HBIOS date/time utility (WDATE).
+-   Kevin Boone has contributed a generic HBIOS date/time utility
+    (WDATE).
 
-- Matt Carroll has contributed a fix to XM.COM that corrects the port
-  specification when doing a send.
+-   Matt Carroll has contributed a fix to XM.COM that corrects the port
+    specification when doing a send.
 
-- Dean Jenkins enhanced the build process to accommodate the Raspberry
-  Pi 4.
+-   Dean Jenkins enhanced the build process to accommodate the Raspberry
+    Pi 4.
 
-- Tom Plano has contributed a new utility (HTALK) to allow talking
-  directly to HBIOS COM ports.
+-   Tom Plano has contributed a new utility (HTALK) to allow talking
+    directly to HBIOS COM ports.
 
-- Lars Nelson has contributed several generic utilities such as a
-  universal (OS agnostic) UNARC application.
+-   Lars Nelson has contributed several generic utilities such as a
+    universal (OS agnostic) UNARC application.
 
-- Dylan Hall added support for specifying a secondary console.
+-   Dylan Hall added support for specifying a secondary console.
 
-- Bill Shen has contributed boot loaders for several of his systems.
+-   Bill Shen has contributed boot loaders for several of his systems.
 
-- Laszlo Szolnoki has contributed an EF9345 video display controller
-  driver.
+-   Laszlo Szolnoki has contributed an EF9345 video display controller
+    driver.
 
-- Ladislau Szilagyi has contributed an enhanced version of CP/M Cowgol
-  that leverages RomWBW memory banking.
+-   Ladislau Szilagyi has contributed an enhanced version of CP/M Cowgol
+    that leverages RomWBW memory banking.
 
-- Les Bird has contributed support for the NABU w/ Option Board
+-   Les Bird has contributed support for the NABU w/ Option Board
 
-- Rob Gowin created an online documentation site via MkDocs, and
-  contributed a driver for the Xosera FPGA-based video controller.
-
-- Jörg Linder has contributed disassembled and nicely commented source
-  for ZSDOS2 and the BPBIOS utilities.
+-   Rob Gowin created an online documentation site via MkDocs, and
+    contributed a driver for the Xosera FPGA-based video controller.
 
+-   Jörg Linder has contributed disassembled and nicely commented source
+    for ZSDOS2 and the BPBIOS utilities.
 
 Related Projects
 
@@ -393,10 +383,7 @@ describes not only generic CP/M application development, but also RomWBW
 HBIOS programming and bare metal programming. The latest copy of this
 document is hosted at http://w8bh.net/Assembly for RC2014Z.pdf.
 
-
-
-LICENSING
-
+Licensing
 
 License Terms
 

Source/Doc/Catalog.md

@@ -1121,7 +1121,7 @@ The following files are found in
 | `TESTAS.SUB`   | SUBMIT file to build TESTAS sample program |
 | `Z80AS.COM`    | Z80 assembler which assembles the output of COWFIX and other Z80 source files (see <https://github.com/Laci1953/Z80AS>) |
 
-## Microsoft Fortran 80 (Fortran)
+## Microsoft Fortran 80
 
 | Floppy Disk Image: **fd_fortran.img**
 | Hard Disk Image: **hd_fortran.img**
@@ -1267,6 +1267,106 @@ The following files are found in
 | `UNIXIO.H`     | Language include file (see manual) |
 | `ZAS.COM`      | The assembler - in fact a general purpose macro  assembler |
 
+## Infocom (Text Adventure Games)
+
+| Hard Disk Image: **hd_infocom.img**
+
+A collection of all Official releases of the interactive fiction games
+produced by Infocom in the 1980's
+
+The following files are found in
+
+*  /Source/Images/d_infocom
+
+| **File**    | **Description**                                    |
+|-------------|----------------------------------------------------|
+| amfv.z4     | A Mind Forever Voyaging (*)                        |
+| arthur.z6   | Arthur - The Quest for Excalibur (*)               |
+| ballyhoo.z3 | Ballyhoo                                           |
+| beyond.z5   | Beyond Zork (*)                                    |
+| border.z5   | Border Zone (*)                                    |
+| bureau.z4   | Bureaucracy (*)                                    |
+| cutthr.z3   | Cutthroats                                         |
+| deadline.z3 | Deadline                                           |
+| enchant.z3  | Enchanter                                          |
+| h2g2.z3     | The Hitchhiker's Guide to the Galaxy               |
+| hollyw.z3   | Hollywood Hijinx                                   |
+| infidel.z3  | Infidel                                            |
+| journey.z6  | Journey (*)                                        |
+| leather.z3  | Leather Goddesses of Phobos                        |
+| lurking.z3  | The Lurking Horror                                 |
+| moonmist.z3 | Moonmist                                           |
+| nordbert.z4 | Nord and Bert Couldn't Make Head or Tail of It (*) |
+| planet.z3   | Planetfall                                         |
+| plunder.z3  | Plundered Hearts                                   |
+| readme.txt  | Additional Documentation                           |
+| seastalk.z3 | Seastalker                                         |
+| sherlock.z5 | Sherlock (*)                                       |
+| shogun.z6   | Shogun (*)                                         |
+| sorcerer.z3 | Sorcerer                                           |
+| spellb.z3   | Spellbreaker                                       |
+| starcros.z3 | Starcross                                          |
+| stationf.z3 | Stationfall                                        |
+| suspect.z3  | Suspect                                            |
+| suspend.z3  | Suspended                                          |
+| trinity.z4  | Trinity (*)                                        |
+| wishb.z3    | Wishbringer                                        |
+| witness.z3  | Witness                                            |
+| zork0.z6    | Zork Zero (*)                                      |
+| zork1.z3    | Zork I                                             |
+| zork2.z3    | Zork II                                            |
+| zork3.z3    | Zork III                                           |
+
+The above games have been curated from here <https://eblong.com/infocom/>.
+Full game documentation can be found here <https://infodoc.plover.net/>
+
+The game files are a virtual machine code commonly known as Z-Machine, they
+are portable and will run on any machine that has a Z-Machine interpreter.
+
+* All the Z3 games come with the official CP/M interpreter (the `COM` file) 
+  version C last updated by Inforcom on 5th Feb 1985. You can simply run the
+  game by running it from the `COM` program  
+* All latter games Z4, Z5,.. and above, (Marked as * in the listing above)
+  are more sophisticated and require a better interpreter. i.e. VEZZA. 
+
+#### VEZZA (User Area 15)
+
+Vezza is a modern Infocom/Inform/Z-machine text adventure interpreter for 8 bit
+z80 based computers.  What makes it modern is that it is written in hand-crafted
+z80 assembler for maximum speed, and can load not only the classics such as
+Zork 1,2 and 3 but also the later games.
+
+It can run Z1 up to Z8 inform format interactive fiction game files. To run 
+a game with Vezza just type Vezza followed by the game you want to run. e.g.
+
+`VEZZA ZORK0.Z6`
+
+**Note:** One of the bigger constraints is available RAM. An OS such as ZPM
+since it uses banked RAM does have a good amount of available RAM and was 
+used to test these games work.
+
+This tool is free but the developer accepts your support by letting
+you pay what you think is fair for the tool. If you find this useful
+consider donating at: 
+
+<https://sijnstra.itch.io/vezza>
+
+You should (test and) choose one that works on you configuration,
+and best to copy and rename it as vezza.com
+
+| **File**     | **Description**                                                   |
+|--------------|-------------------------------------------------------------------|
+| vezza-B.com  | 80x24, VT52 + Banked CP/M 3                                       |
+| vezza-FG.com | 80x25, VT100/ANSI (16 color) + CP/M 3                             |
+| vezza-C2.com | 80x24, VT100 - CP/M 2.2 large memory, no timed input              |
+| vezza-CC.com | 80x24, VT100 (256 colour) - CP/M 2.2 large memory, no timed input |
+| vezza-AV.com | 80x24, VT100 (16 colour) - CP/M 2.2 high RAM.                     |
+| vezza-AX.com | 80x25, VT100/ANSI (16 colour) - CP/M 2.2 high RAM.                |
+| vezza-RW.com | 80x24, VT100 - CP/M 2.2                                           |
+
+The above is a subset of available builds. The full repository including 
+documentation is available at <https://gitlab.com/sijnstra1/vezza/>
+
 ## MSX ROMS
 
 | Hard Disk Image: **hd_msxroms1.img**
@@ -1329,7 +1429,7 @@ The following files are found in
 | `TURBO.OVR`    | Part of TURBO Pascal           |
 | `TURBOMSG.OVR` | Part of TURBO Pascal           |
 
-## WordStar 4
+## WordStar 4 (Word processor)
 
 | Floppy Disk Image: **fd_ws4.img**
 | Hard Disk Image: **hd_ws4.img**

Source/Doc/Introduction.md

@@ -290,6 +290,7 @@ please let me know if I missed you!
   - significant content in the Disk Catalog and User Guide
   - creation of the Introduction and Hardware documents
   - Z3PLUS operating system disk image
+  - Infocom text adventure game disk image
   - COPYSL, and SLABEL utilities
   - Display of bootable slices via "S" command during startup
   - Optimisations of HBIOS and CBIOS to reduce overall code size

Source/Doc/UserGuide.md

@@ -1806,6 +1806,7 @@ The following table shows the disk images available.
 | xxx_fortran.img   | Microsoft Fortran-80 Compiler        | No       |
 | xxx_games.img     | Games Disk for CP/M                  | No       |
 | xxx_hitechc.img   | HI-TECH Z80 CP/M C compiler          | No       |
+| xxx_infocom.img   | Infocom Games Disk                   | No       |
 | xxx_msxroms1.img  | MSX ROMs Disk 1                      | No       |
 | xxx_msxroms2.img  | MSX ROMs Disk 2                      | No       |
 | xxx_nzcom.img     | NZCOM ZCPR 3.4 Operating System      | Yes      |

Source/Images/Build.cmd

@@ -50,6 +50,7 @@ call BuildDisk.cmd games hd wbw_hd512 || exit /b
 call BuildDisk.cmd cowgol hd wbw_hd512 || exit /b
 call BuildDisk.cmd msxroms1 hd wbw_hd512 || exit /b
 call BuildDisk.cmd msxroms2 hd wbw_hd512 || exit /b
+call BuildDisk.cmd infocom hd wbw_hd512 || exit /b
 
 echo.
 echo Building Combo Disk (512 directory entry format) Image...
@@ -78,6 +79,7 @@ call BuildDisk.cmd games hd wbw_hd1k || exit /b
 call BuildDisk.cmd cowgol hd wbw_hd1k || exit /b
 call BuildDisk.cmd msxroms1 hd wbw_hd1k || exit /b
 call BuildDisk.cmd msxroms2 hd wbw_hd1k || exit /b
+call BuildDisk.cmd infocom hd wbw_hd1k || exit /b
 
 if exist ..\BPBIOS\bp*.rel call BuildDisk.cmd bp hd wbw_hd1k ..\zsdos\zsys_wbw.sys || exit /b
 

Source/Images/Makefile

@@ -14,7 +14,7 @@ HD512IMGS = hd512_cpm22.img hd512_zsdos.img hd512_nzcom.img \
 HD512XIMGS = hd512_z80asm.img hd512_aztecc.img hd512_hitechc.img \
 	hd512_bascomp.img hd512_fortran.img hd512_games.img \
 	hd512_tpascal.img hd512_dos65.img hd512_qpm.img \
-	hd512_z3plus.img \
+	hd512_z3plus.img hd512_infocom.img \
 	hd512_cowgol.img hd512_msxroms1.img hd512_msxroms2.img \
 	hd512_cobol.img  hd512_blank.img
 HD1KIMGS = hd1k_cpm22.img hd1k_zsdos.img hd1k_nzcom.img \
@@ -22,7 +22,7 @@ HD1KIMGS = hd1k_cpm22.img hd1k_zsdos.img hd1k_nzcom.img \
 HD1KXIMGS = hd1k_z80asm.img hd1k_aztecc.img hd1k_hitechc.img \
 	hd1k_bascomp.img hd1k_fortran.img hd1k_games.img \
 	hd1k_tpascal.img hd1k_qpm.img \
-	hd1k_z3plus.img \
+	hd1k_z3plus.img hd1k_infocom.img \
 	hd1k_cowgol.img hd1k_msxroms1.img hd1k_msxroms2.img \
 	hd1k_cobol.img hd1k_blank.img
 HD1KXIMGS += hd1k_bp.img

Source/Images/d_games/Readme.txt

@@ -2,6 +2,8 @@
 
 This disk contains several games for CP/M including the Infocom games
 Zork 1 through 3, Planetfall and Hitchhiker's Guide to the Galaxy.
+A complete collection of all infocom games is available on the separate
+INFOCOM disk image
 
 Nemesis and Dungeon Master is a Rogue-like game released in 1981. It is playable
 on a text terminal using ASCII graphics to represent the dungeon. Only a few

Source/Images/d_infocom/Readme.txt

@@ -0,0 +1,116 @@
+
+===== INFOCOM GAMES =====
+
+A collection of all official releases of the interactive fiction games
+produced by Infocom in the 1980's. The copyright rests with Activision.
+
+Game List follows including the revision number and release date
+
+amfv.z4 - (A Mind Forever Voyaging) - r77-s850814.z4
+arthur.z6 - (Arthur) - r74-s890714
+ballyhoo.z3 - (Ballyhoo) - r97-s851218
+beyond.z5 - (Beyond Zork) - r57-s871221
+border.z5 - (Border Zone) - r9-s871008
+bureau.z4 - (Bureaucracy) - r116-s870602
+cutthr.z3 - (Cutthroats) - r23-s840809
+deadline.z3 - (Deadline) - r27-s831005
+enchant.z3 - (Enchanter) - r29-s860820
+h2g2.z3 - (The Hitchhiker's Guide to the Galaxy) - r59-s851108
+hollyw.z3 - (Hollywood Hijinx) - r37-s861215
+infidel.z3 - (Infidel) - r22-s830916
+journey.z6 - (Journey) - r83-s890706
+leather.z3 - (Leather Goddesses of Phobos) - r59-s860730
+lurking.z3 - (The Lurking Horror) - r203-s870506
+moonmist.z3 - (Moonmist) - r9-s861022
+nordbert.z4 - (Nord and Bert Couldn't Make Head or Tail of It) - r19-s870722
+planet.z3 - (Planetfall) - r37-s851003
+plunder.z3 - (Plundered Hearts) - r26-s870730
+seastalk.z3 - (Seastalker) - r16-s850603
+sherlock.z5 - (Sherlock) - r26-s880127
+shogun.z6 - (Shogun) - r322-s890706
+sorcerer.z3 - (Sorcerer) - r15-s851108
+spellb.z3 - (Spellbreaker) - r87-s860904
+starcros.z3 - (Starcross) - r17-s821021
+stationf.z3 - (Stationfall) - r107-s870430
+suspect.z3 - (Suspect) - r14-s841005
+suspend.z3 - (Suspended) - r8-s840521
+trinity.z4 - (Trinity) - r12-s860926
+wishb.z3 - (Wishbringer) - r69-s850920
+witness.z3 - (Witness) - r22-s840924
+zork0.z6 - (Zork 0) - r393-s890714
+zork1.z3 - (Zork 1) - r88-s840726
+zork2.z3 - (Zork 2) - r48-s840904
+zork3.z3 - (Zork 3) - r17-s840727
+
+The versions above are generally from the "Classic Text Adventure
+Masterpieces" released by Activision in (1996) which is the source of
+most modern releases.
+
+The version of Hitchhiker is the one that Douglas Adams postedon his web
+site in the mid-90s. The BBC later posted an illustrated version based
+on the same game file.
+
+The above games have been curated from here <https://eblong.com/infocom/>.
+Full game documentation can be found here <https://infodoc.plover.net/>
+
+The game files are a virtual machine code commonly known as Z-Machine, they
+are portable and will run on any machine that has a Z-Machine interpreter.
+
+All the Z3 games come with the official CP/M interpreter (Version C) last
+updated by Inforcom on 5th Feb 1985
+
+All latter games Z4, Z5,.. and above, are more sophisticated and require
+a better interpreter. i.e. VEZZA.
+
+VEZZA
+
+Vezza is a modern Infocom/Inform/Z-machine text adventure interpreter for
+8 bit z80 based computers.  What makes it modern is that it is written in
+hand-crafted z80 assembler for maximum speed, and can load not only the
+classics such as Zork 1,2 and 3 but also the latter games.
+
+It can run Z1 up to Z8 inform format interactive fiction game files. To run
+a game with Vezza just type Vezza followed by the game you want to run. e.g.
+
+`VEZZA ZORK0.Z6`
+
+**Note:** One of the bigger constraints is available RAM. An OS such as ZPM
+since it uses banked RAM does have a good amount of available RAM and was
+used to test these games work.
+
+This tool is free but the developer accepts your support by letting you
+pay what you think is fair for the tool. If you find this useful consider
+donating at:
+
+https://sijnstra.itch.io/vezza
+
+The following files are located in user area 15
+
+Available builds (requires CP/M version 3 or compatible system):
+  vezza-b.com  - 80x24 screen, vt52 + Banked CP/M 3
+  vezza-FG.com - 80x30 screen, VT100/ANSI CP/M 3 (tested on Z80-MBC2 & FabGL)
+
+Other builds (Large memory CP/M 2.2, no timed input):
+  vezza-C2.com - 80x24 RunCPM VT100 - no colour
+  vezza-CC.com - 80x24 RunCPM VT100 with 256 ANSI colour codes
+
+Slow builds due to BIOS limitations (extra register presevation, less cache,
+smaller memory build):
+  vezza-AV.com - CP/M 2.2 with VT100 codes plus 16 bit ANSI colour & high
+                 RAM. Works on Agon Light CP/M 2.2
+                 Note: Issues with very high I/O such as screen animations
+  vezza-AX.com - CP/M 2.2 with VT100 codes plus 16 bit ANSI colour, high
+                 RAM & FabGL Italic. Works on Agon Light CP/M 2.2
+                 Note: Issues with very high I/O such as screen animations
+  vezza-RW.com - CP/M 2.2 with VT100 codes plus 16 bit ANSI colour with low
+                 RAM. Tested on RC 2014 SC-126 using TeraTerm
+
+You should (test and) choose one that works on you configuration, and
+ideally copy and rename it as vezza.com, so the Alias COM files can find
+and execute the game.
+
+The above is a subset of available builds. The full repository is available
+at https://gitlab.com/sijnstra1/vezza/
+
+
+

Source/Images/d_infocom/u15/README.TXT

@@ -0,0 +1,8 @@
+VEZZA
+
+Please see official documentation at the following links
+
+https://sijnstra.itch.io/vezza
+
+https://gitlab.com/sijnstra1/vezza
+

Source/Images/hd_infocom.txt

@@ -0,0 +1,4 @@
+#
+# Add the ReadMe document
+#
+d_infocom/Readme.txt 0: