cpc4x  V 0.24:               (c) 1999, 2000, 2001, Ulrich Cordes
==============

This is a beta version of a AMSTRAD CPC emulator for X11. I build 
it with S.u.S.E. Linux.

 IMPORTANT
     If you have installed an earlier version of cpc4x than 0.20, please 
     rename the "cpc" directory in your (or every users) home directory
     to "cpc_old" first.

     Only after this, the emulator will be installed correctly while its first
     start! Later you must copy your "dsk" files from the "cpc_old/disc" to the
     "cpc/disc" directory.


You can compile this emulator as system administrator and makes so the 
emulator useable for all users on the machine where you install it. In 
that case you need root access.

If you do not have root access, you must compile the emulator in single user
mode.

_______________________________________________________________________________

Sytemadministrator installation:
--------------------------------
1. Login as root and extract the cpc4x_***.tgz file in a directory of your 
   choise, e.g. /usr/src/SOURCE. Use the following shell command for extract

      tar -xvzf cpc4x.tgz

   A subdirectory "cpc" will be created automaticaly. After extracting change
   with "cd cpc" into the new directory.

2. If you use an Intel based operating system (386 or higer) goto step 5

3. Now you must find out what kind of microprocessor you use. Is it a high 
   endian (INTEL 386 or higher) or a low endian (?) type. To find it out, 
   translate the file "processor.c" with the following command:

   cc -o processor src/processor.c

   Start the test program now by typing "./processor". The test program should
   show, if you use a high endian or a low endian processor.

4. Edit the "Makefile.admin" file and choice the right processor type 
   in the first lines.  Set the variable PROCESSOR to -DLSB_FIRST if
   you use a low endian processor or to -DMSB_FIRST if you use a high endian one.

5. Set in the Makefile.admin the installation directory where the emulator binary
   file will be copied to after "make -f Makefile.admin install" command. 

   INSTALLDIR = /usr/lib/cpc

   As next set the user working directory, which will be created in every 
   users home directory, if the user starts the emulator the first time.
   
   USERSUBDIR = cpc

   Set the BINDIR variable to a directory which is included by the PATH 
   variable. The Makefile will create a script file there which starts
   the emulator by typing "cpc". Example:

   BINDIR = /usr/X11/bin

6. Type 

     make -f Makefile.admin config
     make -f Makefile.admin 
     make -f Makefile.admin install
     make -f Makefile.admin clean
   

Now the emulator should be installed in the directory structure as been 
describe in the doc/DirectoryStructure.txt file.

Every user can start the emulator by typing the command "cpc"

_______________________________________________________________________________


Single user installation for no root access:
--------------------------------------------
1. To install this emulator as single user login on your system 

2. Copy the cpc4x_***.tgz file to your home directory and extract it with the
   shell command:
  
      tar -xvzf cpc4x.tgz

   A subdirectory "cpc" will be created automaticaly. After extracting change
   with "cd cpc" into the new directory.

3. If you use an Intel based operating system (386 or higer) goto step 6

4. Now you must find out what kind of microprocessor you use. Is it a high 
   endian (INTEL 386 or higher) or a low endian (?) type. To find it out, 
   translate the file "processor.c" with the following command:

   cc -o processor src/processor.c

   Start the test program now by typing "processor". The test program should
   show, if you use a high endian or a low endian processor.

5. Edit the "Makefile.user" and choice the right processor type in the first 
   lines. Set the variable PROCESSOR to -DLSB_FIRST if you use a low endian 
   processor or to -DMSB_FIRST if you use a high endian one.

6. Set in "Makefile.user" the variables INSTALLDIR = $(HOME)/cpc, 
   the USERSUBDIR = /cpc and the BINDIR = $(HOME)/bin

7. If not exists, create a "bin" directory in your home directory with

   mkdir $HOME/bin

8. Type 

     make -f Makefile.user config
     make -f Makefile.user 
     make -f Makefile.user install

     To clean up type   rm -r src/*.o     
     Do not(!) use      make -f Makefile.user clean!!!

Now you can start the CPC emulator by typing "cpc". 

_______________________________________________________________________________

The emulator do not work perfect now, but you can use it to run your old 
CPC basic programs. I work hard on the emulator but I need time for it.
If you want to help me, pleas contact me.


Keys:
-----

F1  - Info and help dialog
F3  - insert a disk image as A:
F4  - insert a disk image as B:
F7  - shows a setup dialog
F8  - resets the emulation
F12 - exit the emulation


Author:
-------

Ulrich Cordes
Vor der Dorneiche 1
34317 HABICHTSWALD

GERMANY


email:  ulrich.cordes@gmx.de
WWW:    http://www.amstrad-cpc.de   (my CPC homepage in english language)
        http://www.schneider-cpc.de (my CPC homepage in german language )



EOF          (c) 1999, 2000, Ulrich Cordes

