Add MSXROMs

- Les Bird has given permission to include his extensive library of MSX ROM images.  Please see https://github.com/lesbird/MSX8 for more information.
- Appropriate MSX8 ROM player and hardware required to use these.
- Provided as supplemental RomWBW disk image slices (msxroms1.img, msxroms2.img).

Co-Authored-By: Les Bird <lesbird65@gmail.com>

ReadMe.md

@@ -3,7 +3,7 @@
 **RomWBW ReadMe** \
 Version 3.5 \
 Wayne Warthen  ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \
-19 Aug 2024
+21 Aug 2024
 
 # Overview
 

ReadMe.txt

@@ -1,6 +1,6 @@
 RomWBW ReadMe
 Wayne Warthen (wwarthen@gmail.com)
-19 Aug 2024
+21 Aug 2024
 
 
 

Source/Doc/UserGuide.md

@@ -1985,13 +1985,38 @@ new combo disk image.
 
 #### Custom Hard Disk Image
 
-If you want to use specific slices in a specific order, you can easily
-generate a custom hard disk image file.
-
 For hard disks, each .img file represents a single slice (CP/M 
 filesystem).  Since a hard disk can contain many slices, you can just 
 concatenate the slices (.img files) together to create your desired hard
-disk image.  For example, if you want to create a hard disk image that 
+disk image.  
+
+If you look in the Binary directory of the distribution, you will see
+that there are more disk (slice) images than the 6 that are included
+in the "combo" disk images.  These images are identified by looking
+for the files that start with hd1k_ or hd512_.
+
+You can add slices to the combo disk images simply by tacking
+slices onto the end.  For example, if you want to add a slice
+containing the MSX ROMs to the end of the combo image, you could
+use one of the following command lines depending on your operating
+system:
+
+Windows:
+
+`COPY /B hd1k_combo.img + hd1k_msxroms.img my_hd.img` 
+
+Linus/MaxOS:
+
+`cat hd1k_combo.img hd1k_msxroms.img >my_hd.img`
+
+Note that you **must** be sure to use either the hd1k_ or hd512_
+prefixed files together.  You cannot mix them.
+
+If you want to create a completely custom hard disk image that is not
+based on the existing combo image, you can generate a disk image entirely
+from scratch using whatever slices you want in whatever order you like.
+
+For example, if you want to create a hard disk image that 
 has slices for CP/M 2.2, CP/M 3, and WordStar in the hd512 format, you 
 would use the command line of your modern computer to create the final 
 image:

Source/Images/Build.cmd

@@ -24,7 +24,6 @@ call BuildDisk.cmd fortran hd wbw_fd144 || exit /b
 call BuildDisk.cmd games hd wbw_fd144 || exit /b
 call BuildDisk.cmd cowgol hd wbw_fd144 || exit /b
 
-
 echo.
 echo Building Hard Disk Images (512 directory entry format)...
 echo.
@@ -45,6 +44,8 @@ call BuildDisk.cmd bascomp hd wbw_hd512 || exit /b
 call BuildDisk.cmd fortran hd wbw_hd512 || exit /b
 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
 
 echo.
 echo Building Combo Disk (512 directory entry format) Image...
@@ -69,6 +70,8 @@ call BuildDisk.cmd bascomp hd wbw_hd1k || exit /b
 call BuildDisk.cmd fortran hd wbw_hd1k || exit /b
 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
 
 if exist ..\BPBIOS\bp*.rel call BuildDisk.cmd bp hd wbw_hd1k ..\zsdos\zsys_wbw.sys || exit /b
 

Source/Images/d_msxroms1/ReadMe.txt

@@ -0,0 +1,19 @@
+===== MSX ROMs Disk for RomWBW =====
+
+This is disk 1 of 2 of the collection of MSX ROMs as provided by Les 
+Bird (ROM filenames A-K).  These ROMs are "run" by using the 
+appropriate variant of Les' MSX8 ROM loader.  You can download the 
+loader binaries from https://github.com/lesbird/MSX8.  You will need
+appropriate hardware to run the loader.
+
+Please review the file ROMLIST.TXT for information on the current
+operational status of the ROM and it's long file name/description.
+
+This disk (RomWBW slice) is not automatically included with the
+RomWBW "combo" disk images.  You can simply add it to a combo
+image by appending it to the end.  After booting your system,
+you can use the ASSIGN command to map the slice to a drive letter.
+Refer to the RomWBW User Guide for more information on this
+process.
+
+-- WBW 11:15 AM 8/21/2024