****************************************************
*                                                  *                    
*                PCOTT VERSION 0.07b               *
*               General Documentation              *                    
*                                                  *                    
****************************************************

Platforms   : MsDos
Revision    : 0.07b
Last Update : 11/17/1998
Authors     : Julien FRELAT "Gollum"
              Main Code/MsDos Port/Unix Port/HomePage Maintener
	      frelat@iie.cnam.fr	

What is it ?
------------
Pcott is a PC 80x86/80x286 emulator entirely written in C and C++.
It works on various platforms (MsDos).

How I use it ?
--------------
"Pcott" is the name of the executable program.
You need PC executable files, ".COM" files, in order to run it.

Syntax :
      PC_FR <pc_file_name[.COM]> [options] (MsDos French)
ou    PC_EN <pc_file_name[.COM]> [options] (MsDos English)
ou DBGPC_FR <pc_file_name[.COM]> [options] (MsDos Debugger French)
ou DBGPC_EN <pc_file_name[.COM]> [options] (MsDos Debugger English)

Options :
 /f[rameskip] XX or -f[rameskip] XX to skip 1 frame/XX
 /j[oy] or -j[oy] disables joystick detection
 /v[sync] or -v[sync] enables VBL sync
 /h[elp] or -h[elp] or -? or /? displays help

What is emulated ?
------------------
- Intel 80x86/80x286 CPUs
- VGA Video memory
- Video mode : MCGA 320x200 
- Standard PC Keyboard
- Partial interrupts : 10
- COM files loading
- 1 Mo RAM emulated

What are the special features ?
-------------------------------
- Little GUI with system messages
- 320x200 (MsDos)
- Screen centered in current resolution
- Built-in debugger
- Two versions : Emulator or Debugger
- Two languages : French or English
- Frame skipping
- One or two joysticks autodetection (MsDos)
- Reset/Pause/Halt keys
- Screenshot saving in Bmp format
- 1Mo snapshot loading and saving (real-time game savings)
- Number of frames per second (FPS) rendered
- Number of instructions per second (IPS) executed
- Parameters to configure the entire emulator

What are the keys ? (MsDos)
-------------------
BACKSPACE : Reset Emulation
        P : Pause Emulation (Then, any key to return to PC emulation)
       F2 : Save current screen in .BMP
       F5 : Save snapshot of current game in .COT
       F6 : Load snapshot of current game in .COT
      F12 : Halt Emulation (return to debugger) 
    ECHAP : Exit Emulation

What about requirements ? (MsDos)
-------------------------
- Fast Pentium
  If it is TOO SLOW, increase frame skipping and do not use -vsync parameter
  If it is TOO FAST, decrease frame skipping and use -vsync parameter
- 2 Mo of RAM is enough
- MsDOS Version 5.00 or above

Pcott works fine (but *SLOW* !!!) in a DOS box under Win95.
You need to switch to entire screen under WinNT.

What is new ?
-------------
Project started November 98

 0.07b : - Very huge work !!!
         - 165PLASM (165 bytes PLASMA DEMO) WORKS PERFECTLY !!!
	 - Bugs or problems to fix
           * VERY VERY SLOW
	   * FPS and IPS do not work
           * Snapshots do not work
         - Many bugs fixed
           * MUL/DIV emulation
           * Flags emulation
           * Ports emulation
         - Debugger improved and fixed
           * Some opcodes
           * Groups
         - Emulation works highly better
           * About 75% of all opcodes added
           * STOSW/OUTSB added
           * Mod R/M 8/16 bits works
           * Many many things done
           * AND/XOR/OR/SUB/SBB/ADC/ADD/JMP added
           * Memory adressing fixed
           * First loop seems to work !

 0.06b : - Fetch Byte & Fetch Word fixed

 0.05b : - More huge work !!!
         - Segment & offset added
         - Start interrupt emulation
         - Start BIOS emulation (initvideo)
           * DOS 80x25 works
           * MCGA 320x200x256 works
         - Start graphic emulation (putpixel)
         - Start keyboard emulation
         - Start flags emulation (CF up to OF)
         - Start ports emulation (IN & OUT)
         - Improve standard opcodes emulation (ADD/SUB/AND/OR/XOR)
         - Improve flag emulation speed (may apply to Boycott too...)
         - RET stop emulation
         - Debugger improved and fixed
           * CALL address
           * Signed opcodes fixed
           * All shift group 2 opcodes added
           * Disp 8 bits fixed
           * Segment displaying
           * Flag displaying

 0.04b : - Huge work !!!
           * All 256 standard opcodes added in a table (phew !)
           * All 165PLASM.COM opcodes well recognized

 0.03b : - Debugger improvements
           * Group 1/2/3/4 added
           * Mod R/M byte seems to work (disp 8/16 bits, mod 00/01/10/11)
           * Instructions with registers 8/16 bits added
           * Next instruction bug fixes (corrected in Boycott too...)
           * Signed operations

 0.02b : - Emulation started with some instructions
	 - Debugger started
	   * Shift group 2
	   * Mod R/M byte
	   * Registers display
	 - i86 registers

 0.01b : - First executable version under MsDos

Who I would like to acknowledge ?
---------------------------------
- Toyot because, without him, I would have never discovered Emulation Scene
- INTEL for 80386 docs
- Microsoft for Msdos and Debug
- Richard for interest in this project
- DRT for maybe his logos
- My girlfriend (I love you) and my sister for their great patience

Where can I find Pcott ?
--------------------------
http://www-eleves.iie.cnam.fr/themes/Emu5ever/pcot2.html (Official Pcott Homepage)
