From e7ed6ed27c5b1a0b57e811f1aa6f844d2f8961d9 Mon Sep 17 00:00:00 2001 From: Mark Pruden Date: Sat, 11 May 2024 18:08:57 +1000 Subject: [PATCH] Moved Documentation into Doc/CPM folder --- Doc/{ => CPM}/CPM Manual.pdf | Bin Doc/{ => CPM}/CPM3 Command Summary.pdf | Bin Doc/{ => CPM}/CPM3 Programmers Guide.pdf | Bin Doc/{ => CPM}/CPM3 System Guide.pdf | Bin Doc/{ => CPM}/CPM3 Users Guide.pdf | Bin Doc/{ => CPM}/NZCOM Users Manual.pdf | Bin Doc/CPM/ReadMe.txt | 67 +++++++++++++++++++++++ Doc/{ => CPM}/ZCPR Manual.pdf | Bin Doc/{ => CPM}/ZCPR-DJ.doc | 0 Doc/{ => CPM}/ZSDOS Manual.pdf | 0 Doc/{ => CPM}/qcp27.pdf | Bin Doc/{ => CPM}/qdos27.pdf | Bin Doc/{ => CPM}/qpm27.pdf | Bin Doc/ReadMe.txt | 62 +++------------------ Source/Doc/UserGuide.md | 24 ++++---- Source/Images/d_nzcom/ReadMe.txt | 10 ++-- Source/Images/d_qpm/ReadMe.txt | 14 ++--- Source/Images/d_zsdos/ReadMe.txt | 8 +-- 18 files changed, 102 insertions(+), 83 deletions(-) rename Doc/{ => CPM}/CPM Manual.pdf (100%) rename Doc/{ => CPM}/CPM3 Command Summary.pdf (100%) rename Doc/{ => CPM}/CPM3 Programmers Guide.pdf (100%) rename Doc/{ => CPM}/CPM3 System Guide.pdf (100%) rename Doc/{ => CPM}/CPM3 Users Guide.pdf (100%) rename Doc/{ => CPM}/NZCOM Users Manual.pdf (100%) create mode 100644 Doc/CPM/ReadMe.txt rename Doc/{ => CPM}/ZCPR Manual.pdf (100%) rename Doc/{ => CPM}/ZCPR-DJ.doc (100%) rename Doc/{ => CPM}/ZSDOS Manual.pdf (100%) rename Doc/{ => CPM}/qcp27.pdf (100%) rename Doc/{ => CPM}/qdos27.pdf (100%) rename Doc/{ => CPM}/qpm27.pdf (100%) diff --git a/Doc/CPM Manual.pdf b/Doc/CPM/CPM Manual.pdf similarity index 100% rename from Doc/CPM Manual.pdf rename to Doc/CPM/CPM Manual.pdf diff --git a/Doc/CPM3 Command Summary.pdf b/Doc/CPM/CPM3 Command Summary.pdf similarity index 100% rename from Doc/CPM3 Command Summary.pdf rename to Doc/CPM/CPM3 Command Summary.pdf diff --git a/Doc/CPM3 Programmers Guide.pdf b/Doc/CPM/CPM3 Programmers Guide.pdf similarity index 100% rename from Doc/CPM3 Programmers Guide.pdf rename to Doc/CPM/CPM3 Programmers Guide.pdf diff --git a/Doc/CPM3 System Guide.pdf b/Doc/CPM/CPM3 System Guide.pdf similarity index 100% rename from Doc/CPM3 System Guide.pdf rename to Doc/CPM/CPM3 System Guide.pdf diff --git a/Doc/CPM3 Users Guide.pdf b/Doc/CPM/CPM3 Users Guide.pdf similarity index 100% rename from Doc/CPM3 Users Guide.pdf rename to Doc/CPM/CPM3 Users Guide.pdf diff --git a/Doc/NZCOM Users Manual.pdf b/Doc/CPM/NZCOM Users Manual.pdf similarity index 100% rename from Doc/NZCOM Users Manual.pdf rename to Doc/CPM/NZCOM Users Manual.pdf diff --git a/Doc/CPM/ReadMe.txt b/Doc/CPM/ReadMe.txt new file mode 100644 index 00000000..af2b90fa --- /dev/null +++ b/Doc/CPM/ReadMe.txt @@ -0,0 +1,67 @@ +*********************************************************************** +*** *** +*** R o m W B W *** +*** *** +*** Z80/Z180 System Software *** +*** *** +*********************************************************************** + +This directory ("Doc/CPM") is part of the RomWBW System Software +distribution archive. It contains documentation for the CP/M +operating system components of the system. + + +CPM Manual ("CPM Manual.pdf") +----------------------------- + +The original DRI CP/M 2.x Operating System Manual. This should be +considered the primary reference for system operation. The section +on CP/M 2 Alteration can be ignored since this work has already been +completed as part of the RomWBW distribution. + + +CPM3 Command Summary ("CPM3 Command Summary.pdf") +CPM3 Programmer's Guide ("CPM3 Programmers Guide.pdf") +CPM3 System Guide ("CPM3 System Guide.pdf") +CPM3 User's Guide ("CPM3 Users Guide.pdf") +------------------------------------------------------ + +The original DRI CP/M 3.0 Operating System Documentation Set. This +should be considered the primary reference for CP/M 3 system operation. + + +NZCOM User's Manual ("NZCOM Users Manual.pdf") +---------------------------------------------- + +NZCOM operating system operation manual. + + +QP/M 2.7 Installation Guide and Supplements ("qpm27.pdf") +QP/M 2.7 Interface Guide ("qdos27.pdf") +QP/M 2.7 Features and Facilities ("qcp27.pdf") +-------------------------------------------- + +Official documentation set for QP/M 2.7 from original QP/M distribution. + + +ZCPR Manual ("ZCPR Manual.pdf") +------------------------------- + +ZCPR is the command proccessor portion of Z-System. This is the +manual for ZCPR 1.x as included in RomWBW. The installation +instructions can be ignored since that work has already been +completed as part of the RomWBW distribution. + +ZCPR D&J Manual ("ZCPR-DJ.doc") +------------------------------- + +ZCPR D&J User Manual. This manual supplements the ZCPR Manual. + + +ZSDOS Manual ("ZSDOS Manual.pdf") +--------------------------------- + +ZSDOS is the DOS portion of Z-System. This is the manual for ZSDOS +1.x as included in RomWBW. The installation instructions can be +ignored since that work has already been completed as part of the +RomWBW distribution. diff --git a/Doc/ZCPR Manual.pdf b/Doc/CPM/ZCPR Manual.pdf similarity index 100% rename from Doc/ZCPR Manual.pdf rename to Doc/CPM/ZCPR Manual.pdf diff --git a/Doc/ZCPR-DJ.doc b/Doc/CPM/ZCPR-DJ.doc similarity index 100% rename from Doc/ZCPR-DJ.doc rename to Doc/CPM/ZCPR-DJ.doc diff --git a/Doc/ZSDOS Manual.pdf b/Doc/CPM/ZSDOS Manual.pdf similarity index 100% rename from Doc/ZSDOS Manual.pdf rename to Doc/CPM/ZSDOS Manual.pdf diff --git a/Doc/qcp27.pdf b/Doc/CPM/qcp27.pdf similarity index 100% rename from Doc/qcp27.pdf rename to Doc/CPM/qcp27.pdf diff --git a/Doc/qdos27.pdf b/Doc/CPM/qdos27.pdf similarity index 100% rename from Doc/qdos27.pdf rename to Doc/CPM/qdos27.pdf diff --git a/Doc/qpm27.pdf b/Doc/CPM/qpm27.pdf similarity index 100% rename from Doc/qpm27.pdf rename to Doc/CPM/qpm27.pdf diff --git a/Doc/ReadMe.txt b/Doc/ReadMe.txt index 49f8a7cc..b7a290d6 100644 --- a/Doc/ReadMe.txt +++ b/Doc/ReadMe.txt @@ -10,6 +10,12 @@ This directory ("Doc") is part of the RomWBW System Software distribution archive. It contains documentation for components of the system. +CPM (Directory) +--------------- + +Documentation Specific to CP/M, including all versions and derivatives + + ChangeLog.txt ------------- @@ -31,25 +37,6 @@ and utilities are detailed in the Applications and ROM Applications documents. -CPM Manual ("CPM Manual.pdf") ------------------------------ - -The original DRI CP/M 2.x Operating System Manual. This should be -considered the primary reference for system operation. The section -on CP/M 2 Alteration can be ignored since this work has already been -completed as part of the RomWBW distribution. - - -CPM3 Command Summary ("CPM3 Command Summary.pdf") -CPM3 Programmer's Guide ("CPM3 Programmers Guide.pdf") -CPM3 System Guide ("CPM3 System Guide.pdf") -CPM3 User's Guide ("CPM3 Users Guide.pdf") ------------------------------------------------------- - -The original DRI CP/M 3.0 Operating System Documentation Set. This -should be considered the primary reference for CP/M 3 system operation. - - DDTZ Manual ("DDTZ.doc") ------------------------ @@ -69,47 +56,12 @@ Hard Disk Anatomy ("Hard Disk Anatomy.pdf") Diagram of a CP/M & MS-DOS (FAT) hybrid hard disk layout. -NZCOM User's Manual ("NZCOM Users Manual.pdf") ----------------------------------------------- - -NZCOM operating system operation manual. - - -ZCPR Manual ("ZCPR Manual.pdf") -------------------------------- - -ZCPR is the command proccessor portion of Z-System. This is the -manual for ZCPR 1.x as included in RomWBW. The installation -instructions can be ignored since that work has already been -completed as part of the RomWBW distribution. - -ZCPR D&J Manual ("ZCPR-DJ.doc") -------------------------------- - -ZCPR D&J User Manual. This manual supplements the ZCPR Manual. - - -ZSDOS Manual ("ZSDOS Manual.pdf") ---------------------------------- - -ZSDOS is the DOS portion of Z-System. This is the manual for ZSDOS -1.x as included in RomWBW. The installation instructions can be -ignored since that work has already been completed as part of the -RomWBW distribution. - Microsoft Basic-80 Reference Manual v5.0 (Microsoft Basic-80 Reference Manual v5.0.pdf) --------------------------------------------------------------------------------------- Official manual for Microsoft BASIC as included in RomWBW. -QP/M 2.7 Installation Guide and Supplements ("qpm27.pdf") -QP/M 2.7 Interface Guide ("qdos27.pdf") -QP/M 2.7 Features and Facilities ("qcp27.pdf") --------------------------------------------- - -Official documentation set for QP/M 2.7 from original QP/M distribution. - SIO+CTC Baud Rate Options (SIO+CTC Baud Rate Options.pdf) --------------------------------------------------------- @@ -165,4 +117,4 @@ FORTRAN-80 User Manual (Microsoft_FORTRAN-80_Users_Manual_1977.pdf) Official user manual for Microsoft's FORTRAN-80 compiler included in the fortran disk image. ---WBW 5:18 PM 6/14/2023 \ No newline at end of file +--WBW 5:18 PM 6/14/2023 diff --git a/Source/Doc/UserGuide.md b/Source/Doc/UserGuide.md index 04ba281f..c54b6e17 100644 --- a/Source/Doc/UserGuide.md +++ b/Source/Doc/UserGuide.md @@ -2241,7 +2241,7 @@ less likely to encounter compatibility issues. #### Documentation -* [CPM Manual]($doc_root$/CPM Manual.pdf) +* [CPM Manual]($doc_root$/CPM/CPM Manual.pdf) #### Boot Disk @@ -2287,9 +2287,9 @@ via the NZ-COM adaptation (see below). #### Documentation -* [ZCPR Manual]($doc_root$/ZCPR Manual.pdf) -* [ZCPR-DJ]($doc_root$/ZCPR-DJ.doc) -* [ZSDOS Manual]($doc_root$/ZSDOS Manual.pdf) +* [ZCPR Manual]($doc_root$/CPM/ZCPR Manual.pdf) +* [ZCPR-DJ]($doc_root$/CPM/ZCPR-DJ.doc) +* [ZSDOS Manual]($doc_root$/CPM/ZSDOS Manual.pdf) #### Boot Disk @@ -2376,7 +2376,7 @@ Manual.pdf" document in order to use this operating system effectively. #### Documentation -* [NZCOM Users Manual]($doc_root$/NZCOM Users Manual.pdf) +* [NZCOM Users Manual]($doc_root$/CPM/NZCOM Users Manual.pdf) #### Boot Disk @@ -2401,10 +2401,10 @@ has a new suite of support tools and help system. #### Documentation -* [CPM3 Users Guide]($doc_root$/CPM3 Users Guide.pdf) -* [CPM3 Command Summary]($doc_root$/CPM3 Command Summary.pdf) -* [CPM3 Programmers Guide]($doc_root$/CPM3 Programmers Guide.pdf) -* [CPM3 System Guide]($doc_root$/CPM3 System Guide.pdf) +* [CPM3 Users Guide]($doc_root$/CPM/CPM3 Users Guide.pdf) +* [CPM3 Command Summary]($doc_root$/CPM/CPM3 Command Summary.pdf) +* [CPM3 Programmers Guide]($doc_root$/CPM/CPM3 Programmers Guide.pdf) +* [CPM3 System Guide]($doc_root$/CPM/CPM3 System Guide.pdf) #### Boot Disk @@ -2553,9 +2553,9 @@ regarding the RomWBW adaptation and customizations. #### Documentation -* [QP/M 2.7 Installation Guide and Supplements]($doc_root$/qpm27.pdf) -* [QP/M 2.7 Interface Guide]($doc_root$/qdos27.pdf) -* [QP/M 2.7 Features and Facilities]($doc_root$/qcp27.pdf) +* [QP/M 2.7 Installation Guide and Supplements]($doc_root$/CPM/qpm27.pdf) +* [QP/M 2.7 Interface Guide]($doc_root$/CPM/qdos27.pdf) +* [QP/M 2.7 Features and Facilities]($doc_root$/CPM/qcp27.pdf) #### Boot Disk diff --git a/Source/Images/d_nzcom/ReadMe.txt b/Source/Images/d_nzcom/ReadMe.txt index 15d11f7e..c6aa5604 100644 --- a/Source/Images/d_nzcom/ReadMe.txt +++ b/Source/Images/d_nzcom/ReadMe.txt @@ -16,7 +16,7 @@ User Guide.pdf" document found in the Doc directory of the RomWBW Distribution. The primary documentation for NZ-COM is the "NZCOM Users Manual.pdf" -document contained in the Doc directory of the RomWBW distribution. +document contained in the Doc/CPM directory of the RomWBW distribution. This document is a supplement to the primary documentation. Additionally, please review the file called RELEASE.NOT on this disk which contains a variety of updates regarding the NZ-COM distribuition. @@ -77,7 +77,7 @@ The following additional customizations were also performed: The following files came from the official NZCOM distribution. These are generally documented in the "NZCOM Users Manual.pdf" document in -the Doc directory of the RomWBW distribution. Note that some of the +the Doc/CPM directory of the RomWBW distribution. Note that some of the files included in the NZ-COM distribution are not listed below because they have been superseded by more recent versions listed in other sections below. For example, TCSELECT is not listed here, but a more @@ -164,7 +164,7 @@ The following files have been included from CP/M 2.2. These files provide various functionality that is not really available from the ZSDOS applications themselves. For example, the CP/M 2.2 application called STAT is useful for modifying the IOBYTE. Most of these -applications are documented in the "CPM Manual.pdf" document in the Doc +applications are documented in the "CPM Manual.pdf" document in the Doc/CPM directory of the RomWBW distribution. ASM.COM - DRI 8080 assembler producing Intel hex files @@ -180,7 +180,7 @@ XSUB.COM - DRI batch file enhancer resident system extension == ZSDOS Files == The following files came from the official ZSDOS distribution. These -are generally documented in the "ZSDOS Manual.pdf" document in the Doc +are generally documented in the "ZSDOS Manual.pdf" document in the Doc CPM directory of the RomWBW distribution. These files are relevant under NZ-COM because ZSDOS is a part of the NZ-COM system. @@ -320,4 +320,4 @@ in this user area for more information. N.B., at a minimum, some of the files in this user area must be copied to user area 0 for CP/NET to work properly. --- WBW 11:19 AM 1/22/2024 \ No newline at end of file +-- WBW 11:19 AM 1/22/2024 diff --git a/Source/Images/d_qpm/ReadMe.txt b/Source/Images/d_qpm/ReadMe.txt index 5704aba2..d76c741d 100644 --- a/Source/Images/d_qpm/ReadMe.txt +++ b/Source/Images/d_qpm/ReadMe.txt @@ -36,12 +36,12 @@ code brakpoints. This conflicts the use of that vector for any system that is using interrupt mode 1. DEBUGZ can be configured (using DBGINST) to use a different vector. -The QSTAMP program, which is used to initialize a disk for date/time -stamping, misbehavews when run on the (new) RomWBW 1024 directory -format disks. It creates an invalid directory entry for the date/time -stamp data file. This is definitely a QP/M issue. The directory entry -can be manually corrected. Specifically the byte offset 15 should -contain the number of 128-byte records in the file. Instead, it is set +The QSTAMP program, which is used to initialize a disk for date/time +stamping, misbehavews when run on the (new) RomWBW 1024 directory +format disks. It creates an invalid directory entry for the date/time +stamp data file. This is definitely a QP/M issue. The directory entry +can be manually corrected. Specifically the byte offset 15 should +contain the number of 128-byte records in the file. Instead, it is set to 0x01. You can edit the entry, change it to 0x80 and everything starts working. @@ -92,7 +92,7 @@ The following files have been included from CP/M 2.2. These files provide various functionality that is not really available from the ZSDOS applications themselves. For example, the CP/M 2.2 application called STAT is useful for modifying the IOBYTE. Most of these -applications are documented in the "CPM Manual.pdf" document in the Doc +applications are documented in the "CPM Manual.pdf" document in the Doc/CPM directory of the RomWBW distribution. ASM.COM - DRI 8080 assembler producing Intel hex files diff --git a/Source/Images/d_zsdos/ReadMe.txt b/Source/Images/d_zsdos/ReadMe.txt index 53cfd778..e3316534 100644 --- a/Source/Images/d_zsdos/ReadMe.txt +++ b/Source/Images/d_zsdos/ReadMe.txt @@ -15,7 +15,7 @@ ZSDOS is a replacement for the BDOS portion of the CP/M 2.2 operating system. Since it does not include it's own command processor, the the ZCPR D&J Command Processor has been included. -The primary documentation for ZSDOS and ZCPR 1 are contained in the Doc +The primary documentation for ZSDOS and ZCPR 1 are contained in the Doc/CPM directory of the RomWBW distribution. The specific files are "ZSDOS Manual.pdf", "ZCPR Manual.pdf", and "ZCPR-DJ.doc". This document is a supplement to the primary documentation. @@ -141,7 +141,7 @@ distribution as possible. == ZSDOS 1.1 Files == The following files came from the official ZSDOS distribution. These -are generally documented in the "ZSDOS Manual.pdf" document in the Doc +are generally documented in the "ZSDOS Manual.pdf" document in the Doc/CPM directory of the RomWBW distribution. Note that some of the files included in the ZSDOS distribution are not listed below because they have been superseded by more recent versions listed in other sections @@ -192,7 +192,7 @@ The following files have been included from CP/M 2.2. These files provide various functionality that is not really available from the ZSDOS applications themselves. For example, the CP/M 2.2 application called STAT is useful for modifying the IOBYTE. Most of these -applications are documented in the "CPM Manual.pdf" document in the Doc +applications are documented in the "CPM Manual.pdf" document in the Doc/CPM directory of the RomWBW distribution. ASM.COM - DRI 8080 assembler producing Intel hex files @@ -304,4 +304,4 @@ in this user area for more information. N.B., at a minimum, some of the files in this user area must be copied to user area 0 for CP/NET to work properly. --- WBW 3:20 PM 8/27/2021 \ No newline at end of file +-- WBW 3:20 PM 8/27/2021