Minor Documentation Updates

Doc/ChangeLog.txt

@@ -20,6 +20,7 @@ Version 3.6
 - WBW: Improved image creation process to allow user defined aggregates
 - WBW: Implemented config driven slice name and system image specification
 - D?N: Added native USB driver support (keyboard, floppy, mass storage)
+- MGG: Added sample program source files for all language disk iamges
 
 Version 3.5.1
 -------------

ReadMe.md

@@ -7,7 +7,7 @@
 **RomWBW Introduction** \
 Version 3.6 \
 Wayne Warthen  ([wwarthen@gmail.com](mailto:wwarthen@gmail.com)) \
-22 Jul 2025
+29 Jul 2025
 
 # Overview
 
@@ -355,6 +355,9 @@ let me know if I missed you!
 - Jörg Linder has contributed disassembled and nicely commented source
   for ZSDOS2 and the BPBIOS utilities.
 
+- Marshall Gates has contriubed sample program source files for all of
+  the language disk images.
+
 ## Related Projects
 
 Outside of the hardware platforms adapted to RomWBW, there are a variety

ReadMe.txt

@@ -1,6 +1,6 @@
 RomWBW Introduction
 Wayne Warthen (wwarthen@gmail.com)
-22 Jul 2025
+29 Jul 2025
 
 
 
@@ -78,7 +78,7 @@ Some of the included software:
 - 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
+- Microsoft Basic Compiler, Microsoft Fortran, and Microsoft COBOL
 - Some games such as Colossal Cave, Zork, etc
 - Wordstar Word processing software
 
@@ -362,6 +362,9 @@ let me know if I missed you!
 - Jörg Linder has contributed disassembled and nicely commented source
   for ZSDOS2 and the BPBIOS utilities.
 
+- Marshall Gates has contriubed sample program source files for all of
+  the language disk images.
+
 
 Related Projects
 

Source/Doc/Catalog.md

@@ -769,7 +769,7 @@ distribution.  Some provide command line help themselves.  Some are fairly obvio
 
 ## OS General Files
 
-The following files are spcific files share across several OS's.  
+The following files are specific files shared across several OS's.  
 In general, there is no documentation for these applications included with 
 the RomWBW distribution.  Some provide command line help themselves.  
 Some are fairly obvious.
@@ -788,6 +788,7 @@ The following files are found in
 | `COPY.COM`     | Z                 | File copier with ZSDOS date stamping awareness        |
 | `COPY.CFG`     | Z                 | ZCNFG configuration file for COPY application         |
 | `EDITNDR.COM`  | Z3                | Edit named directory register in memory.              |
+| `HELLO.ASM`    | CPM22             | Sample assembly language source file                  |
 | `HP-RPN.HLP`   | Z3                | Help File for ZP.COM - HP RPN Calculators             |
 | `HP-ZP.HLP`    | Z3                | Help File for ZP.COM - HP ZP Calculators              |
 | `KERCPM22.COM` | CPM22             | Kermit communication application                      |

Source/Doc/Introduction.md

@@ -71,7 +71,7 @@ Some of the included software:
 * 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
+* Microsoft Basic Compiler, Microsoft Fortran, and Microsoft COBOL
 * Some games such as Colossal Cave, Zork, etc
 * Wordstar Word processing software
 
@@ -339,6 +339,9 @@ please let me know if I missed you!
 * Jörg Linder has contributed disassembled and nicely commented
   source for ZSDOS2 and the BPBIOS utilities.
 
+* Marshall Gates has contriubed sample program source files for all
+  of the language disk images.
+
 `\clearpage`{=latex}
 
 ## Related Projects

Source/Images/all.def.example

@@ -1,6 +1,8 @@
 # This image definition shows how to generate
-# an disk image containing all of the available
-# slices.
+# a disk image containing all of the available
+# slices.  Remove the ".example" suffix from this
+# file and to cause the RomWBW build process to
+# create the "all" disk image.
 
 aztecc
 bascomp

Source/Images/d_aztecc/Readme.txt

@@ -25,6 +25,12 @@ as-is.
 Bill Buckels
 bbuckels@mts.net
 
+== Sample Application ==
+
+This disk image includes a very small sample application called
+HELLO.C that can be used to demonstrate the build process.  The
+following commands will build this sample application.
+
 cz hello
 as hello
 ln hello.o -lc

Source/Images/d_bascomp/Readme.txt

@@ -59,8 +59,3 @@ Data    4000    4197    <  407>
 A>hello
 
 Hello World
-
-
-A> 
-BASCOM =HELLO /E
-L80 HELLO,HELLO/N/E

Source/Images/d_cobol/Readme.txt

@@ -13,5 +13,11 @@ be run easily on 8080, z-80 or 8085 systems.
 The user manual is available in the Doc/Language directory,
 Microsoft_COBOL-80_Manuals_1878.pdf
 
+== Sample Application ==
+
+This disk image includes a very small sample application called
+HELLO.COB that can be used to demonstrate the build process.  The
+following commands will build this sample application.
+
 cobol hello,hello=hello/r
 l80 hello/n,hello/e

Source/Images/d_cpm22/ReadMe.txt

@@ -141,7 +141,7 @@ BBCBASIC.TXT - Help file for BBC BASIC
 GENHEX.COM - Generates an Intel Hex file from the input file
 LS.COM - An alternative file listing to DIR
 LSWEEP.COM - Can extract and view member files of an .LBR archive
-
+HELLO.ASM - Sample assembly language application
 
 == Testing Applications (User Area 2) ==
 
@@ -167,4 +167,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
+-- WBW 12:57 PM 7/29/2025

Source/Images/d_fortran/Readme.txt

@@ -9,5 +9,11 @@ the 8080/Z80 platform, not the language specification version)
 The user manual is available in the Doc/Language directory,
 Microsoft_FORTRAN-80_Users_Manual_1977.pdf
 
+== Sample Application ==
+
+This disk image includes a very small sample application called
+HELLO.FOR that can be used to demonstrate the build process.  The
+following commands will build this sample application.
+
 f80 hello,hello=hello
 l80 hello,forlib/s,hello/n,/e:hellow

Source/Images/d_tpascal/Readme.txt

@@ -13,3 +13,10 @@ Turbo_Pascal_Version_3.0_Reference_Manual_1986.pdf
 
 A good overview of using Turbo Pascal in CP/M is available at
 https://techtinkering.com/2013/03/05/turbo-pascal-a-great-choice-for-programming-under-cpm/
+
+== Sample Application ==
+
+This disk image includes a very small sample application called
+HELLO.PAS that can be used to demonstrate the build process.  Building
+a Turbo Pacal application is an interactive process that is documented
+in the Reference Manual.

Source/Images/demo_dev.def.example

@@ -1,3 +1,9 @@
+# This image definition generates a disk image containing
+# all of the available language disk slices.
+# Remove the ".example" suffix from this
+# file and to cause the RomWBW build process to
+# create the "demo_dev" disk image.
+
 # This is the programming language demo development Combo image for RomWBW
 
 cpm22

Source/ver.inc

@@ -2,7 +2,7 @@
 #DEFINE	RMN	6
 #DEFINE	RUP	0
 #DEFINE	RTP	0
-#DEFINE BIOSVER	"3.6.0-dev.14"
+#DEFINE BIOSVER	"3.6.0-dev.15"
 #define rmj	RMJ
 #define rmn	RMN
 #define rup	RUP

Source/ver.lib

@@ -3,5 +3,5 @@ rmn	equ	6
 rup	equ	0
 rtp	equ	0
 biosver	macro
-	db	"3.6.0-dev.14"
+	db	"3.6.0-dev.15"
 	endm