Miscellaneous Disk Image Cleanup

- Per Mark Pruden, corrected NZCOM user area specification for CP/M 2.2 files.
- Added some DRI files to CP/M 3 that are documented in the CP/M 3 documentation (LIB, LINK, MAC, RMAC, XREF).  They are duplicated in CP/M 2.2 image, so this should be reviewed at some point.
- Added XREF to CP/M 2 disk image for consistency with CP/M 3.
- Updated Catalog.md per Mark Pruden to eliminate obsolete column from table.

ReadMe.md

@@ -3,7 +3,7 @@
 **RomWBW ReadMe** \
 Version 3.5 \
 Wayne Warthen  ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \
-27 Oct 2024
+08 Nov 2024
 
 # Overview
 

ReadMe.txt

@@ -1,6 +1,6 @@
 RomWBW ReadMe
 Wayne Warthen (wwarthen@gmail.com)
-27 Oct 2024
+08 Nov 2024
 
 
 

Source/Doc/Catalog.md

@@ -1,5 +1,5 @@
 $define{doc_title}{Disk Catalog}$
-$define{doc_author}{Mykl Orders}$
+$define{doc_author}{Mark Pruden \& Mykl Orders}$
 $define{doc_authmail}{}$
 $include{"Book.h"}$
 
@@ -119,29 +119,29 @@ distribution.
 
 The following files appear in User Area 0
 
-| **File**        | **Description**                  | **Also Found In** |
-|-----------------|----------------------------------|-------------------|
-| `ASM.COM`       | 8080 assembler                   | NZCOM, QPM, ZSDOS |
-| `DDT.COM`       | 8080 dynamic debugger            | NZCOM, QPM, ZSDOS |
-| `DUMP.COM`      | type contents of file in hex     | NZCOM, QPM, ZSDOS |
-| `ED.COM`        | line editor                      | NZCOM, QPM, ZSDOS |
-| `HELP.COM`      | CP/M 3 Derived HELP display      | NZCOM, QPM, ZSDOS |
-| `HELP.HLP`      | CP/M 3 Derived HELP data file    | NZCOM, QPM, ZSDOS |
-| `LIB.COM`       | object file library manager      | NZCOM, QPM, ZSDOS |
-| `LINK.COM`      | object file linker               | NZCOM, QPM, ZSDOS |
-| `LOAD.COM`      | loader for Intel hex files       | NZCOM, QPM, ZSDOS |
-| `MAC.COM`       | 8080 macro assembler             | NZCOM, QPM, ZSDOS |
-| `PIP.COM`       | file transfer program            | NZCOM, QPM, ZSDOS |
-| `RMAC.COM`      | 8080 relocating macro assembler  | NZCOM, QPM, ZSDOS |
-| `STAT.COM`      | file/disk/device info & config   | NZCOM, QPM, ZSDOS |
-| `SUBMIT.COM`    | batch file submission tool       | NZCOM, QPM, ZSDOS |
-| `XSUB.COM`      | batch file resident extension    | NZCOM, QPM, ZSDOS |
-| `ZSID.COM`      | Z80 symbolic debugger            | NZCOM, QPM, ZSDOS |
-
-As noted above several of the above files are also present in other 
-disk images besides CP/M 2.2
-
-MAC, RMAC, ZSID are supplemental programs from DRI
+| **File**        | **Description**                                      |
+|-----------------|------------------------------------------------------|
+| `ASM.COM`       | DRI 8080 assembler                                   |
+| `DDT.COM`       | 8080 dynamic debugger                                |
+| `DUMP.COM`      | DRI type contents of file in hex                     |
+| `ED.COM`        | DRI line editor                                      |
+| `HELP.COM`      | CP/M 3 derived HELP display                          |
+| `HELP.HLP`      | CP/M 3 derived HELP data file                        |
+| `LIB.COM`       | DRI object file library manager                      |
+| `LINK.COM`      | DRI object file linker                               |
+| `LOAD.COM`      | DRI loader for Intel hex files                       |
+| `MAC.COM`       | DRI 8080 macro assembler                             |
+| `PIP.COM`       | DRI periperal interchange program                    |
+| `RMAC.COM`      | DRI 8080 relocating macro assembler                  |
+| `STAT.COM`      | DRI file/disk/device info & config                   |
+| `SUBMIT.COM`    | DRI batch file submission tool                       |
+| `XREF.COM`      | DRI assembler cross reference listing utility        |
+| `XSUB.COM`      | DRI batch file resident extension                    |
+| `ZSID.COM`      | DRI Z80 symbolic debugger                            |
+
+**NOTE:** The above files are also included in the NZCOM disk image.
+
+MAC, RMAC, XREF, and ZSID are supplemental programs from DRI
 with separate standalone documentation which is not included in the
 RomWBW package (but easily found on the Internet via Google search).
 
@@ -351,50 +351,61 @@ The following files appear in User Area 0
 | `CPM3.SYS`     | RomWBW     | DRI CPM+ (non-banked) memory image                 |
 | `CPM3RES.SYS`  | RomWBW     | DRI CPM+ (non-banked) memory image                 |
 | `CPM3BNK.SYS`  | RomWBW     | DRI CPM+ (banked) memory image                     |
-| `CPM3FIX.PAT`  | CPM3       |                                                    |
+| `CPM3FIX.PAT`  | CPM3       | DRI CPM+ patch list                                |
 | `CPMLDR.COM`   | RomWBW     | DRI CPM 3.0 Boot Loader Application                |
 | `CPMLDR.SYS`   | RomWBW     | DRI CPM 3.0 Boot Loader for SYSCOPY                |
-| `GENBNK.DAT`   | RomWBW     |                                                    |
-| `GENRES.DAT`   | RomWBW     |                                                    |
-| `GENCPM.DAT`   | RomWBW     | DRI CPM+ System generation tool data file          |
+| `GENBNK.DAT`   | RomWBW     | GENCPM config data file (banked)                   |
+| `GENRES.DAT`   | RomWBW     | GENCPM config data file (non-banked)               |
+| `GENCPM.DAT`   | RomWBW     | Current GENCPM config data file                    |
 | `GENCPM.COM`   | CPM3       | DRI CPM+ Create a memory image of CPM3.SYS         |
 | `RESBDOS3.SPR` | CPM3       | DRI CPM+ GENCPM input file for resident BDOS       |
-| `README.1ST`   | CPM3       |                                                    |
 
 ### CP/M 3 Files
 
 The following CP/M 3 files were distributed by DRI with the operating
-system or as supplemental add-on programs.
+system or as supplemental add-on programs.  They are documented in the
+"CPM3 Command Summary.pdf" document in the Doc/CPM directory of the Rom WBW
+distribution. 
 
 The following files appear in User Area 0
 
-| **File*       | **Description**                                                        |
+| **File**      | **Description**                                                        |
 |---------------|------------------------------------------------------------------------|
 | `DATE.COM`    | DRI CPM+ Set or display the date and time                              |
 | `DEVICE.COM`  | DRI CPM+ Assign logical devices with one or more physical devices      |
 | `DIR.COM`     | DRI CPM+ DIR with options                                              |
 | `DUMP.COM`    | DRI type contents of disk file in hex                                  |
-| `ED.COM`      | DRI context editor                                                     |
-| `ERASE.COM`   | DRI file deletion                                                      |
+| `ED.COM`      | DRI CPM+ line editor                                                   |
+| `ERASE.COM`   | DRI CPM+ file deletion                                                 |
 | `GENCOM.COM`  | DRI CPM+ Generate special COM file with attached RSX files             |
 | `GET.COM`     | DRI CPM+ Temporarily get console input form a disk file                |
 | `HELP.COM`    | DRI CPM+ Display information on how to use commands                    |
 | `HELP.HLP`    | DRI CPM+ Databse of help information for HELP.COM                      |
 | `HEXCOM.COM`  | DRI CPM+ Create a COM file from a hex file output by MAC               |
 | `INITDIR.COM` | DRI CPM+ Initializes a disk to allow time and date stamping            |
+| `LIB.COM`     | DRI object file library manager                                        |
+| `LINK.COM`    | DRI object file linker                                                 |
+| `LOAD.COM`    | DRI loader for Intel hex files                                         |
+| `MAC.COM`     | DRI 8080 macro assembler                                               |
 | `PATCH.COM`   | DRI CPM+ Display or install patch to the CPM+ system or command files  |
-| `PIP.COM`     | DRI Periperal Interchange Program                                      |
+| `PIP.COM`     | DRI CPM+ Periperal Interchange Program                                 |
 | `PUT.COM`     | DIR CPM+ Temporarily redirect printer or console output to a disk file |
 | `RENAME.COM`  | DRI CPM+ Rename a file                                                 |
+| `RMAC.COM`    | DRI 8080 relocating macro assembler                                    |
 | `SAVE.COM`    | DRI CPM+ Copy the contents of memory to a file                         |
 | `SET.COM`     | DIR CPM+ Set file options                                              |
 | `SETDEF.COM`  | DIR CPM+ Set system options including the drive search chain           |
 | `SHOW.COM`    | DIR CPM+ Display disk and drive statistics                             |
-| `SUBMIT.COM`  | DRI batch processor                                                    |
-| `TYPE.COM`    | DIR CPM+ Display the contents of an ASCII character file               |
+| `SUBMIT.COM`  | DRI CPM+ batch processor                                               |
+| `TYPE.COM`    | DRI CPM+ Display the contents of an ASCII character file               |
+| `XREF.COM`    | DRI assembler cross reference listing utility                          |
 | `ZSID.COM`    | DRI Z80 symbolic instruction debugger                                  |                                                                    |
 
-**NOTE:** The above files are also included in the ZPM3 disk image distribution
+**NOTE:** The above files are also included in the ZPM3 and Z3PLUS disk images.
+
+ZSID is a supplemental program from DRI
+with separate standalone documentation which is not included in the
+RomWBW package (but easily found on the Internet via Google search).
 
 ### Additional Files
 

Source/HBIOS/hbios.asm

@@ -1470,7 +1470,6 @@ BOOTWAIT:
 	LD	A,RPH_DEFACR		; ENSURE RPH ACR
 	OUT0	(RPH_ACR),A		; ... REGISTER IS INITIALIZED
 #ENDIF
-
 ;
 ; INITIALIZE DIAGNOSTIC AND/OR FRONT PANEL LED(S) TO INDICATE THE
 ; SYSTEM IS ALIVE. WE HAVE NO RAM AT THIS TIME, SO WE CANNOT USE
@@ -1489,7 +1488,6 @@ BOOTWAIT:
 
 #ENDIF
 ;
-
 #IF (LEDENABLE)
   #IF ((LEDMODE == LEDMODE_STD) | (LEDMODE == LEDMODE_SC))
 	XOR	A			; LED IS INVERTED, TURN IT ON

Source/Images/d_cpm3/ReadMe.txt

@@ -1,7 +1,7 @@
 This is a generic CP/M 3 adaptation for RomWBW.
 
 There are two ways to launch CP/M 3.  First, you can run the command
-CPMLDR from a CP/M 2.2 or Z-System command line.  Alternatively, you
+CPMLDR from a CP/M 2.2 or Z-System command line.  Alternatively, you can
 boot directly into CP/M 3 by choosing the CP/M 3 disk from the RomWBW
 loader prompt.  The CP/M 3 disk must be bootable in this case.
 
@@ -9,13 +9,27 @@ With the following exceptions, the files in this directory came from
 the CP/M 3 binary distribution on "The Unofficial CP/M Web site" at
 http://www.cpm.z80.de/binary.html.
 
-As documented in the "README.1ST" file, the included files have been
+The included files have been
 patched with all applicable DRI patches per CPM3FIX.PAT.
 
-In addition, the following have been added:
+ZSID.COM is the original DRI ZSID distribution, but patched to use 
+RST 6 instead of RST 7 to avoid conflicting with mode 1 interrupts.
 
-- INITDIR.COM was not included.  The copy included is the original
-  DRI distribution, with both patches installed.
+CP/M 3 is now fully Year 2000 compliant. This affects the programs
+DATE.COM, DIR.COM and SHOW.COM.
 
-- ZSID.COM is the original DRI ZSID distribution, but patched to use 
-  RST 6 instead of RST 7 to avoid conflicting with mode 1 interrupts. 
+Dates can be displayed in US, UK or Year-Month-Day format. This is set by
+SETDEF:
+
+Press RETURN to Continue
+      SETDEF [US]
+      SETDEF [UK]
+      SETDEF [YMD]  respectively.
+
+The CCP has a further bug fix: A command sequence such as:
+
+  C1
+  :C2
+  :C3
+
+will now not execute the command C3 if the command C1 failed.

Source/Images/fd_cpm3.txt

@@ -20,7 +20,6 @@ d_cpm3/ReadMe.txt 0:
 ../CPM3/cpm3bnk.sys 0:
 ../CPM3/gencpm.dat 0:
 ../CPM3/cpm3.sys 0:
-../CPM3/readme.1st 0:
 ../CPM3/cpm3fix.pat 0:
 #
 # Add RomWBW utilities

Source/Images/fd_nzcom.txt

@@ -5,7 +5,8 @@ d_nzcom/ReadMe.txt 0:
 #
 # Include CP/M 2.2 files
 #
-d_cpm22/u0/*.* 0:
+d_cpm22/u0/SUBMIT.COM 0:
+d_cpm22/u0/*.* 15:
 #
 # Add RomWBW utilities
 #

Source/Images/hd_cpm3.txt

@@ -20,7 +20,6 @@ d_cpm3/ReadMe.txt 0:
 ../CPM3/cpm3bnk.sys 0:
 ../CPM3/gencpm.dat 0:
 ../CPM3/cpm3.sys 0:
-../CPM3/readme.1st 0:
 ../CPM3/cpm3fix.pat 0:
 #
 # Add RomWBW utilities

Source/Images/hd_nzcom.txt

@@ -5,7 +5,8 @@ d_nzcom/ReadMe.txt 0:
 #
 # Include CP/M 2.2 files
 #
-d_cpm22/u0/*.* 0:
+d_cpm22/u0/SUBMIT.COM 0:
+d_cpm22/u0/*.* 15:
 #
 # Include ZSDOS files
 #