----------------+
Little John 0.2.1
---------------->
Date : 21 March 2000.
Authors : IoYo & Pazoo.

----------------------------------+
Location : www.ljohn.romulation.net
---------------------------------->

-----------+
What is it ?
----------->
  This program is an opensource NES emulator. It is based on Simple Direct Media
Layer (SDL), a great library from Sam Lantiga. It allows you to access video,
sound, joystick on many platform.
  Little John uses the 6502 emulator package from Marat Fayzullin. It is a great
emulator, very portable and quiet fast.

  Little John is still in development stage, but it can run quiet well a lot of
classic nes roms. Remember that you have to own the roms to use them.

  NES is a trademark of Nintendo.
  
---------------+
How to install ?
--------------->
  You can download precompiled version for Linux, Windows and Sun/Solaris.
  If you want to compile the sources by yourself or on another platform, you
will have to use the Makefile and probably edit the 6502 emulator sources.
You will have to check in the M6502.H that the byte order is ok.
(low-endian should have the LSB_FIRST defined, the others not). 
Then launch a 'make' and it should works.
  Be sure to have the latest SDL installed, refer to the SDL website for
more informations. The URL is at the end of this file.
  If you want to port Little John on a new platform, please inform me, I am very 
interested in this. I know that on Mac, the separator, '/', is replaced with a
':', so code should be changed with some define, but I cant test it for now.

-----------------------------+
What does it provide for now ?
----------------------------->

  *- Mappers 0,1,2,4 emulation.
  *- Still some minor graphic bugs in some games. 
Lack of docs about scrolling registers...
  *- Sound : square channels emulated, but not every effects.
  *- Joypads : 2 joypads emulated on keyboard.
  *- Savestate : buggy, but can works sometimes ...
  *- SRAM : recorded, but I have to make a .ini files where people choose 
the directory.
  *- A lot of platform : Unix, Linux, Windows and more ...

----------------+
What is planned ?
---------------->  

  *- Joystick support as SDL is going in this way.
  *- More platforms for the precompiled versions.
  *- Full sound emulation.
  *- Mapper 3 (not hard...) and some others just to run the best games.
  *- PPU 2005,6,7 registers bugfixes.
  *- New graphic modes, with the help of OpenGL (supported in SDL since
v1.1.1).
  
  
--------------+
How to use it ?
-------------->  

  If you can use the gtk frontend, 'Launcher', then it is quiet easy.
  For those who want to use 'ljohn.exe' directly, here is the command line syntax :
  
   Usage --> ljohn romfile [-mapper n] [-dres] [-sound] [-fskip n]
                -mapper n : force mapper to n
                -dres     : double the resolution
                -sound    : enable (buggy) sound
                -fskip n  : select the number of frame to skip
                -freq n   : select frequency (ex : 22050)
                -buff n   : select buffer length (power of 2, 512,1024,...)
                -full     : select 320x200 fullscreen mode
    Keys : 1st player  arrows, c,x,s,d (left,right,down,up,A,B,select,start)
           2nd player  4,6,8,5,7,9,1,2 (same order..., keys are on the keypad)
           ESC -> quit
           shift + F1 (F2,F3,...) save state #1 (#2,#3,...)
           F1 (F2,F3,...) load state #1 (#2,#3,...)

  
-------------+
Known problems
------------->

  The save state is quiet buggy, for I dont save the whole information. It is 
planned to implement the savestate of nesticle, which works well.
  The sound is buggy, there are 2 problems : lack of docs and problems with 
sound update when no frame are skipped. I dont know if it comes from SDL or from
my code.


--------+
Thanks to
-------->

  Pazoo for testing, support and ideas.  
	*- www.ensicaen.ismra.fr/~villemin -*
  The BOSS for believing in us. Check out his great emulation resource,
  	*- www.romulation.net -*
  Sam Lantiga for SDL and his support.
  	*- www.devolution.com/~slouken -*
  Yohsi for his great nes documentation and the parodius network.
  	*- nesdev.parodius.net -*
  Marat Fayzullin for his great m6502 package
  	*- www.komkon.org/fms -*
  Darcnes authors, Loopy for the nes palette.
  	
   
