    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: address removed !!!
    -------------------------------------------------------------------------------

    * 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 *