
The following files are on this disk file:

File		Comment
-------------------------------------------------------------------------------
0-CONTNT.TXT	This file.


0-README.DE	Very detailed additional information about YAZE-AG and it's 
		development (in German language).

0-README.EN	The same in english language.
		(Translated with https://deepl.com/ from German in English)


PROFILE.SUB	Is the standard startup file of CP/M 3.1 which is one time
		running after booting the CP/M 3.1 system.

		In this file are defined defaults for useing CP/M 3.1 and the
		mount instructions of .ydsk.disk-files for mounting them to the
		drives D: to P: with the YAZE-AG system utility SYS.COM. I have
		more .ydsk-disk-files defined in PROFILE.SUB as mounted because
		I put more than 16 .ydsk-disk-files into the $HOME/cpm
		directory which is the directory where the "yaze_bin" app
		(YAZE-AG binary) runs. You can select in PROFILE.SUB which
		.ydsk-disk-files you want to have mounted. 

		Only the three drives A: to C: are mounted at the startup of
		the UNIX-/Linux-App "yaze_bin" by the YAZE-AG run time control
		file (rc-file) ".yazerc". This is necessary to have 3 basic
		disks with the necessary system utlilities of CP/M 3.1 and
		other utilities for the startup of CP/M 3.1 while PROFILE.SUB
		is running and mounts .ydsk-disk-files and runs different
		programms and types the INFO.TXT file at the console.
		Drive A: contens different tools/utilities.
		Drive B: contens all CP/M 3.1 System Utilities.
		Drive C: is the default boot disk with this Readme files and
		where the startup file PROFILE.SUB must be available. Drive C:
		is defined as the boot drive during the generation of CPM3.SYS
		(see drive P: where the disk file "bios3-zsm4.ydsk" is
		mounted).


CPM3.SYS	CP/M 3.1 SYSTEM file (OS kernel) which will be bootet with
		A:BOOTSYS.COM under CP/M 3.0/2.2 itself. YES (!) you can boot/
		start CP/M 3.1 with this two files under CP/M 3.1/2.2 itself
		(e.g. with a new version of a CP/M 3.1 BIOS if you develope
		one). So it's NOT necesary to put CPM3.SYS together with a 
		bootloader on the boot sectors off your real CP/M 3.1 system.
		So you can test a new version of your CP/M 3.1 BIOS without
		writing it on the boot sectors with the risk of no longer being
		able to boot the real CP/M 3.1 system. BOOTSYS.COM is tested on
		my real CPU280-Sytem (MPU Z280) of Tilmann Reh and on several
		other real CP/M 3.1 Z80/Z280 systems.

		In the file A:CPM3.COM (.COM file NOT .SYS file!) is
		BOOTSYS.COM + CPM3.SYS attached together. You can also start
		CP/M 3.1 under CP/M 3.1/2.2 itself by calling CPM3.COM (it's
		the same as calling BOOTSYS.COM).
		You can attach together BOOTSYS.COM + CPM3.SYS to CPM3.COM with
		the command:

			pip cpm3.com=bootsys.com,cpm3.sys

		The BOOTSYS app notices whether a correct CPM3.SYS is attached
		due to the copyright message from Digital Research in the
		attached CPM3.SYS and then boots it without first loading a
		CPM3.SYS file from a drive.
		 
		The CP/M 3.1 boot file "yaze-cpm3.boot" which loads and runs
		the YAZE-AG emulator, when you call the UNIX-/Linux-App
		"yaze_bin" over the shell script "yaze", is identical with
		the CPM3.COM file on drive A:. I transfere A:CPM3.COM to the
		UNIX-/LINUX-host with the A:W.COM utility (write/export CP/M
		files to the host) and rename cpm3.com under Unix/Linux to
		"yaze-cpm3.boot" and put it into the directory of the YAZE-AG
		development.


BIRTHDAY.*	Modula-2 Source- and COM-file to make calculations with your
		Birthday. Have a little fun!

		The sources of the date calculation functions of the TI-58/-59
		and the HP-43 calculators (year ca. 1980) is on drive M: (the
		mounted .ydsk-disk-file is "turbo-modula2.ydsk") in the files
		DAYS.DEF/DAYS.MOD (English version) and TAGE.DEF/TAGE.MOD
		(German version). I have put the compiled files (.SYM and .MCD
		files) of DAYS.DEF/DAYS.MOD and TAGE.DEF/TAGE.MOD into the
		Library file AGL.LIB with the LIB utilitiy of the Turbo-Modula-
		2-System. I have put also the AGL.LIB file into the Library
		search PATH inside the Turbo-Modula-2-Compiler-System (M2.COM).
		When you compile the BIRTHDAY.MOD file to BIRTHDAY.MCD and run
		this .MCD file, the Turbo-Modula-2-System search on the fly
		also in AGL.LIB for the files DAYS.SYM/DAYS.MCD and uses then
		this date calculation functions.
		When you want to produce the .COM file BIRTHDAY.COM, the Turbo-
		Modula-2-linker search also in AGL.LIB for the files DAYS.SYM/
		DAYS.MCD to link all together to the file BIRTHDAY.COM.


CRCKLIST.CRC	File of the CRCs of all files on this disk C:.

			Created with "crc *.* f". This creates CRCKLIST.CRC.
			You test all files only with the command "crc" without
			any parameter. (The CRC.COM app is on drive A:)

		When you change PROFILE.SUB the CRC for this file changes then
		also and does then not match. Please do not wonder.


EX*.*		Source- and COM-files of the Z80 instruction exerciser.


TESTEXAL.SUB	Submit file to test and calculate the speed of the Z80 core on
		this aktual machine. It measures exactly over the system time
		(RTC = Real Time Clock) of Unix/Linux/Net- and FreeBSD/Windows
		how long EXZ80ALL.COM needs and calculates then from this time
		the speed of the Z80 Core against the time which a real 4 MHz
		Z80 needed for EXZ80ALL.COM. For this I develope the TIMEX.COM
		and TIMEXPR.COM utilities which work together with the time
		calculation functions in yaze_bin (YAZE-AG binary).

		On my fastest machine (a TUXEDO notebook with X86_64 processor)
		the Z80 core of YAZE-AG is as fast as a Z80 with 5.005 GHz
		(Giga Hz NOT Mega Hz well noted!).


yazedoc.sub	Submit run file to start an external Web-browser called
		from yaze-ag over the app/symbolic link "x-www-browser"
		with the HTML documentation of YAZE-AG which is in
		./doc_html/index.html.

		Under Debian/RaspberryPiOS the directory /etc/alternatives is
		available. In this directory are a lot of symbolic links with
		standard names (e.g. "x-www-browser") to the real apps under
		/usr/bin (e.g. Chromium, Firefox, Pale Moon, man-pages...).
		When your UNIX-/Linux-distribution have not the
		/etc/alternatives directory with the symbolic link 
		"x-www-browser" you must create the symbolic link
		/usr/local/bin/x-www-browser to your favorite Web-Browser which
		you wish to use to display the HTML documentation.


Wednesday, April 10, 2025
Dipl.-Ing. (FH) Andreas Gerlich, E-Mail: development (at) yaze-ag (dot) de
(University of Ulm, Germany)

Web page of YAZE-AG: https://yaze-ag.de

Nick on irc.libera.chat: 'agl' on channel #yaze (I'am every day in this channel
for support)
