My english is not so good, I hope you understand what I write here.
---
(At the end there are some screen snapshots when yaze-ag-2.20 starts.)
---

Install yaze-ag-2.20:
=====================

Sections:

	1. SOLARIS 8 (Sparc)
	2. LINUX
	3. FreeBSD
	4. Cygwin (Windows)
	5. Mac-OS-X (not yet ready)

 
1. If you want to run yaze-ag under SOLARIS 8 (Sparc) then
   (gcc 3.x.x)

	copy  Makefile_solaris  to  Makefile

	edit Makefile in the section optimizing: Refer the
	switches -mcpu in "man gcc" and set the switches
	like your hardware (default: v9)

	then call "make"

	If you want to install the emulator in the system read the
	notes above in this document.
	To install the files in /usr/local/bin and /usr/local/lib/yaze
	give the command "make install" as root.

 
2. If you want to run yaze-ag unter LINUX then
   (gcc version 3.3 20030226 (prerelease) (openSuSE)

	copy Makefile_linux  to Makefile

	edit Makefile in the section optimizing:
	Refer the section optimizing (gcc 2.x.x and gcc 3.x.x) and
	set -march like your hardware (default: -march=pentium3)

	then call "make".

	If you want to install the emulator in the system read the
	notes above in this document.
	To install the files in /usr/local/bin and /usr/local/lib/yaze
	give the command "make install" as root.

 
3. If you want to run yaze-ag under FreeBSD then

	copy  Makefile_freebsd  to  Makefile

	edit Makefile in the section optimizing:
	Refer the section optimizing (gcc 2.x.x and gcc 3.x.x) and
	set -march like your hardware (default: -march=pentium3)

	then call "make".

	If you want to install the emulator in the system read the
	notes above in this document.
	To install the files in /usr/local/bin and /usr/local/lib/yaze
	give the command "make install" as root.

 
4. If you want to run yaze-ag under Cygwin (Windows) then
   (gcc version 3.3.2 (cygwing special))

	copy  Makefile_cygwin  to  Makefile

	edit Makefile in the section optimizing:
	Refer the section optimizing (gcc 2.x.x and gcc 3.x.x) and
	set -march like your hardware (default: -march=pentium3)

	then call "make".

	If you want to install the emulator in the system read the
	notes above in this document.
	To install the files in /usr/local/bin and /usr/local/lib/yaze
	give the command "make install".

 
4. If you want to run yaze-ag under Mac-OS-X then
   (gcc ?.?.?)

	You have to use the Makefile_solaris

	Refer to section "SOLARIS".

	Which switches are to set, that I don't know at this time.



Notes if you want to install yaze-ag in your system
===================================================

"make install" do following:  (BINDIR, LIBDIR ... are defined in the Makefiles)

    in BINDIR
	install yaze_bin	(yaze-ag executable (the Z80 emulator))
	install cdm		(CP/M Disk Manager)
	install yaze		(a shell script which copies some CP/M disks
				 if necessary and starts yaze_bin, see yaze(1))
	symbolic link  cpm --> yaze
	symbolic link  z80 --> yaze

    in LIBDIR
	install yaze-cpm3.boot	(bootsys + cpm3.sys) (ZPM3)
	install yaze.boot	(Superdos a CP/M 2.2 replacement)

    in MANDIR
	install yaze.1		(man page of yaze-ag)
	install cdm.1		(man page of the CP/M Disk Manager)
	install cpm.1		(reference to yaze.1)
	install z80.1		(reference to yaze.1)

    in DSKDIR
	Install some disks which are copied by the shell script "yaze"
	to $HOME/cpm if necessary (have a look to yaze(1) ).

    in DOCDIR
	install the whole documentation there. The shell script "yaze"
	makes links to this documents in $HOME/cpm/doc.

    in DOCHTMLDIR
        install the whole documentation there in HTML format. The shell
        script "yaze" makes links to this documents in $HOME/cpm/doc_html.



How do you start yaze-ag?
=========================

Start YAZE-AG-2.20 with the shell script "yaze". Look to yaze.1 or
yaze(1) (man yaze) it describes also the strategy of the shell script yaze.

If you does no changes in the Makefile yaze-ag (yaze_bin) will be compiled
with the options -DMMU and -DBOOTSYS. So yaze-ag will load and run
yaze-cpm3.boot at 0100H (BOOTSYS.com+CPM3.SYS) instead of yaze.boot (CP/M 2.2).
If the option -DBOOTSYS is deleted yaze-ag starts CP/M 2.2 (yaze.boot) - then
you can start CP/M 3.1 by simple running cpm3.com (the unix file yaze-cpm3.boot
is the same as cpm3-ok.com).

If you delete the option -DMMU yaze-ag can run only CP/M 2.2 (yaze.boot) then
you have to delete -DBOOTSYS too.

Dokumentation
=============

Look to 00-INDEX.doc it describes the several document files!

The whole dokumentation are in yaze-ag.doc, yaze.doc and the README's,

Yaze-ag.doc and README_BOOTSYS describes my new CP/M 3.1 Bootloader BOOTSYS and
describes why I had to developed BOOTSYS and how BOOTSYS works.

README_BIOS3_Z80 describes the Z80 ASM-files of the CP/M 3.1 BIOS on drive P:
which act as an interface to the yaze-bios (bios.c).

On every yaze-disk is a file with the name "0-README.1ST". This file describes
the contents of the disk.

Let me know if you test yaze-ag-2.20 or if you find an error or you miss a
feature. Feel free and send an email to me.

08 June 2008
Andreas Gerlich
(University of Ulm, Germany)

only text emails please:  (SPAM-Account)
-------------------------------------------------------------------------------

* Begin of screen snapshoots *


Screen snapshoots of YAZE-AG-2.20 at start:

===============================================================================
$ yaze

Yet Another Z80 Emulator by AG, version 2.20 (MMU)
Copyright 1995,1998 Frank D. Cringle. Pagetables Copyright by Michael Haardt.
MMU and CP/M 3.1 extensions Copyright (c) 2000,2008 by Andreas Gerlich.
yaze-ag comes with ABSOLUTELY NO WARRANTY; for details
see the file "COPYING" in the distribution directory.

RAM: 1024 KByte, 4 KByte PAGESIZE, 256 PAGES
MMU: 16 TABLES, 16 PAGEPOINTERS per TABLE, selected MMU-PAGETABLE: 0

Running '/usr/local/lib/yaze/yaze-cpm3.boot'

 BOOTSYS - CPM3.SYS, V 1.20 12.03.2005 Copyright (c) 2000,2008 by A.Gerlich
 No CP/M vektors found, try to boot CP/M 3.1 in cooperation with yaze-ag ...

 Loading CP/M 3.1 ...

 62K TPA

 DRIVES:  A B . . E F G H I J . . M N O P

 CP/M 3.1 BIOS for yaze-ag, V 1.00 15.01.2002, Copyright (c) by A.Gerlich
A>
A>
A>
A>mmuprint       (<-- Prints the status of the MMU)

RAM: 1024 KByte, 4 KByte PAGESIZE, 256 PAGES
MMU: 16 TABLES, 16 PAGEPOINTERS per TABLE, selected MMU-PAGETABLE: 1

Z80-\  T00  T01  T02 T03 T04 T05 T06 T07 T08 T09 T10 T11 T12 T13 T14 T15
ADDR \--------------------------------------------------------------------------
0000 :  10 >  0<  20  30  40  50  6E  1F  8E  9E  AE  BE  CE  DE  EE  FE
1000 :   1 > 11<  21  31  41  51  6D  2F  8D  9D  AD  BD  CD  DD  ED  FD
2000 :   2 > 12<  22  32  42  52  6C  3F  8C  9C  AC  BC  CC  DC  EC  FC
3000 :   3 > 13<  23  33  43  53  6B  4F  8B  9B  AB  BB  CB  DB  EB  FB
4000 :   4 > 14<  24  34  44  54  6A  5F  8A  9A  AA  BA  CA  DA  EA  FA
5000 :   5 > 15<  25  35  45  55  69  6F  89  99  A9  B9  C9  D9  E9  F9
6000 :   6 > 16<  26  36  46  56  68  7F  88  98  A8  B8  C8  D8  E8  F8
7000 :   7 > 17<  27  37  47  57  67  77  87  97  A7  B7  C7  D7  E7  F7
8000 :   8 > 18<  28  38  48  58  66  76  86  96  A6  B6  C6  D6  E6  F6
9000 :   9 > 19<  29  39  49  59  65  75  85  95  A5  B5  C5  D5  E5  F5
A000 :   A > 1A<  2A  3A  4A  5A  64  74  84  94  A4  B4  C4  D4  E4  F4
B000 :   B > 1B<  2B  3B  4B  5B  63  73  83  93  A3  B3  C3  D3  E3  F3
C000 :   C > 1C<  2C  3C  4C  5C  62  72  82  92  A2  B2  C2  D2  E2  F2
D000 :   D > 1D<  2D  3D  4D  5D  61  71  81  91  A1  B1  C1  D1  E1  F1
E000 :   E > 1E<  2E  3E  4E  5E  60  70  80  90  A0  B0  C0  D0  E0  F0
F000 :   F >  F<   F   F   F   F   F   F   F   F   F   F   F   F   F   F
--------------------------------------------------------------------------------

A>
A>
===============================================================================



Screen output of YAZE-AG-2.20 if CP/M 3.1 is already running and you
would start CPM3.COM (BOOTSYS transferes BOOTSYS and the joined CPM3.SYS
from bank 1 (TPA bank) to bank 0 (SYS bank) switch to bank 0 and starts
CP/M 3.1 in bank 0):

===============================================================================
$ yaze

Yet Another Z80 emulator ...
    ... (see above)
    ...
    ...
 CP/M 3.1 BIOS for yaze-ag ...
A>
A>    (<-- CP/M 3.1 is running)
A>
A>cpm3

 BOOTSYS - CPM3.SYS, V 1.20 12.03.2005 Copyright (c) 2000,2008 by A.Gerlich

 CP/M 3.1 is already running and bank 1 is selected! Now move all to bank 0 ...

 Now all is transfered and bank 0 is selected -> CPM3.SYS will be loaded. :-)
 (this message comes after a switch from bank 1 to bank 0)

 Loading CP/M 3.1 ...

 62K TPA

 DRIVES:  A B . . E F G H I J . . M N O P

 CP/M 3.1 BIOS for yaze-ag, V 1.00 15.01.2002, Copyright (c) by A.Gerlich
A>
A>
===============================================================================



Screen output of YAZE-AG-2.20 if CP/M 2.2 is started and CPM3.COM will be run:
(if -DBOOTSYS is deleted in the Makefile the output is the same)

===============================================================================
$ yaze -l -1 -b yaze.boot    (-l (loading address) must be -1 to relocate the
                              the CP/M 2.2 (superdos) in yaze.boot.)

Yet Another Z80 Emulator by AG, version 2.20 (MMU)
Copyright 1995,1998 Frank D. Cringle. Pagetables Copyright by Michael Haardt.
MMU and CP/M 3.1 extensions Copyright (c) 2000,2008 by Andreas Gerlich.
yaze-ag comes with ABSOLUTELY NO WARRANTY; for details
see the file "COPYING" in the distribution directory.

RAM: 1024 KByte, 4 KByte PAGESIZE, 256 PAGES
MMU: 16 TABLES, 16 PAGEPOINTERS per TABLE, selected MMU-PAGETABLE: 0

Running '/usr/local/lib/yaze/yaze.boot'

A>    
A>    (<-- CP/M 2.2 (superdos) is running and bank 0 is selected)
A>
A>cpm3

 BOOTSYS - CPM3.SYS, V 1.20 12.03.2005 Copyright (c) 2000,2008 by A.Gerlich

 Loading CP/M 3.1 ...

 62K TPA

 DRIVES:  A B . . . F G H . . . . M N O P

 CP/M 3.1 BIOS for yaze-ag, V 1.00 15.01.2002, Copyright (c) by A.Gerlich
A>
A>    (<-- CP/M 3.1 is running)
A>
===============================================================================

* End of screen snapshoots *